home *** CD-ROM | disk | FTP | other *** search
/ Power CD-ROM!! 8 / Power CD-ROM 8.iso / dos / gds31d / gds.txt < prev    next >
Encoding:
Text File  |  1994-11-11  |  197.4 KB  |  5,134 lines

  1.  
  2.             █████▀▄▀▄▀ ▀▀▀▀C▀██
  3.             █▀▄▀▄▀▄▀▄▀▀▀▀C▄▄▄▄▄▄▄▄
  4.             █▀▄▀▄▀▀C▄ ▄█▀▄█▀  
  5.             █▀▀C▄ ▄▀ ▄▀▄█▀▄▀▄
  6.             ▀ C▄▀  ██▄▄ ▀▄▀▄▀█
  7.              ▀▄▀▀   C███▄▄▄▄███▀ ▄ ▀▄▀▄██
  8.              ▄▀▄▄▀▀ █▀▀▄▄▀▄▀▄▀▄██
  9.             ▄ ▀▄▀▄▄▀  C ▀▄▀▄▀▄
  10.             ▀▄ ▀▄▀▄▀▀▀█▄█▄█▄▀▀▀▀██████
  11.             █▄▄▀ ▄█  ▄▀C▄ ▀██  ▄C▀████
  12.             ████▀ █▄ ▄█  █▄ █  ████████
  13.             ▀▀▀▀C▀▀▀▀▀C▀▀C▄ ▀▀▀▀▀▀▀▀
  14.             ▄▄▄▄C▄▄C▄C▄▄C▄▄▄▄ ▄▄▄▄
  15.             ████▄ █  █  █▀  ████   ████
  16.             █████▄ ▀  █  ▀ ▄█▄C▀█▀   ████
  17.             ███████▄▄▄█▄▄▄▄ ▄███▄▄▄█▄████
  18.  
  19.      GDS.TXT - This is a data file.  DO NOT modify or distribute separately.
  20.  
  21.     Copyright (c)1991-95 Photodex Corporation.  All rights reserved.
  22.       Photodex is a registered trademark of Photodex Corporation.
  23. 
  24.  
  25.  
  26. Tampering with this file is a violation of federal copyright laws and
  27. international treaties.  Violators will be prosecuted to the fullest
  28. extent of the law.
  29.  
  30.  
  31.  
  32. :::catRes
  33.  
  34. (press 'Esc' to cancel)
  35.  
  36.  
  37. Select Catalog Image Resolution:
  38.  
  39. A- 320x200
  40. B- 640x400
  41. C- 640x480 (default)
  42. D- 800x600
  43. E- 1024x768
  44. F- 1280x1024
  45.  
  46. Which? :::catFType
  47. Select Catalog File Type
  48.  
  49. G- GIF (16 to 256 colors)
  50. J- JPEG (24 bit/16M colors)
  51.  
  52. Which? :::catDepth
  53. GIF89a
  54.  
  55. Select GIF Catalog Bit Depth
  56.  
  57. A- 4 bit / 16 colors
  58. B- 8 bit / 256 colors
  59.  
  60. Which? :::cat24
  61.  
  62.  
  63. There are 24 bit files in this batch. Palette optimization requires more
  64. processing.  JPEG files require 5-10 seconds more per file to process
  65. because of redundant decompression.
  66.  
  67.  
  68. Select Palette Quality
  69.  
  70. A- Lame (fast, but image quality is not great)
  71. B- Best possible palette (a bit slower, but the wait is worth it)
  72.  
  73. Which? :::catStyle
  74.  
  75. Select GDS Catalog Style
  76.  
  77. A- Black, no borders
  78. B- Black with borders
  79. C- White, no borders
  80. D- White with borders
  81. E- Gray, no borders
  82. F- Gray, 3D borders (default)
  83.  
  84. Which? :::catLay
  85.  
  86. Select GDS Catalog Layout (%d files)
  87.  
  88. :::catNoVirt
  89.  
  90. Not enough memory for virtual screen file.  Catalog cannot be generated.
  91.  
  92. Press any key to continue.
  93. :::catFinal
  94.  
  95.  
  96.  
  97. If you have not seen a recent copy of GDS, you should!  GDS has been given
  98. a new look and overhauled by Photodex, and is now the most complete graphics
  99. file viewer/cataloger in the world.  It has the fastest viewing capabilities
  100. and user interface of any mainstream graphics programs.  Better yet, GDS out-
  101. does just about every other file viewer, file cataloger, or file converter!
  102. GDS is now used by professionals worldwide to manage thousands of graphics
  103. files every day.  Become a graphics professional -- Discover GDS.
  104.  
  105. Search this system for GDS*.ZIP or GDS*.EXE to get the best file viewer ever.
  106. GDS is shareware, affordable, and registration help is always included.
  107.  
  108. Generating GDS catalog, this takes a minute or two...(Press 'Esc' to cancel)
  109.  
  110. :::vidType
  111.  
  112.  
  113. Ready to attempt detection of video hardware.  NOTE: Some notebooks crash
  114. during video detection.  If the screen locks up after you press [Enter]
  115. (give it 10-20 seconds), simply reboot and use one of the numbers or letters
  116. here. See the help system for more information, or the end of GDS.TXT if
  117. you are familiar with low level video hardware.
  118. (Video types marked with '*' may not be 100%% detectable on all machines.)
  119.  
  120.  1-HERC  *5-AHEAD    *9-CIRRUS    D-F1280   H-SS24X    *L-TSENG    P-ST64
  121.  2-CGA    6-AHEADB   *A-CL54      E-GENOA   I-STEALTH  *M-TSENG4
  122.  3-EGA    7-ATI      *B-EVEREX   *F-OAK     J-STPRO    *N-VESA
  123. *4-VGA    8-CHIPS     C-EV634    *G-PARA   *K-TRIDNT    O-VIDEO7
  124.  
  125. Press [Enter] for automatic detection,
  126. or select the video type number from the above list. :::selfCfg
  127. GDS %s SELF CONFIGURATION
  128.  
  129. If the machine locks up, reset and try GDS /VESA
  130. :::vBIOSChg
  131.  
  132.  
  133. Attention:  The video BIOS has changed since the file CONFIG was created.
  134. GDS checks the video BIOS to detect new video hardware.  If you are using
  135. a 'smart' extended memory manager (like QEMM), this may happen every time
  136. you start GDS.  You can disable this message by inserting the following
  137. command in the file GDSUSER.CFG:
  138.  
  139.     auto,/OK
  140.  
  141.  
  142. Press [Enter]    to use existing CONFIG file
  143. Press   'R'      to Reconfigure GDS
  144.  
  145. Which? :::selfCfg2
  146. GDS %s SELF CONFIGURATION
  147.  
  148. Video type set to %s
  149.  
  150. Some video cards lock the machine up when asked about VESA support.
  151. Do you want to try to detect VESA support (Y/N)? :::svDet
  152.  
  153. Stealth VRAM detected.  Make sure you have run SMODE MONITOR
  154. Press [Enter] to continue, or [Esc] to exit.:::m32Det
  155.  
  156. ATI MACH 32 detected.  Make sure you have run VVESA to support VESA modes,
  157. and have run the INSTALL utility to configure the Mach 32 for your display.
  158. If you have not done this, you should press [Esc] now and RUN ATI's INSTALL.
  159.  
  160.  
  161. *** IF YOU DO NOT RUN VVESA BEFORE GDS, YOU WILL HAVE NO SVGA MODES! ***
  162.  
  163.  
  164. If you have already configured GDS without VVESA loaded, be sure to delete
  165. the file called 'CONFIG' and re-run GDS.  You may also want to run GDS with
  166. /C0 on the command line to insure that the palette is correct.  The Mach 32
  167. card appears to have palette hardware bugs in 1280x1024x256, although all
  168. other modes appear to work fine and do not require the /C0 parameter.
  169.  
  170. Press [Enter] to continue, or [Esc] to exit.:::m64Det
  171.  
  172. ATI MACH 64 detected.  Make sure you have run INSTALL to configure the card.
  173. Press [Enter] to continue, or [Esc] to exit.:::vDet
  174.  
  175. Viper detected.  Make sure you have run VPRMODE VESA
  176. Press [Enter] to continue, or [Esc] to exit.:::sDet
  177.  
  178. Stealth Pro detected.  Make sure you have run STLMODE VESA
  179. Press [Enter] to continue, or [Esc] to exit.:::s64Det
  180.  
  181. Stealth 64 detected.
  182. Make sure you have S64MODE in your AUTOEXEC.BAT file.
  183. Press [Enter] to continue, or [Esc] to exit.:::noIdea
  184.  
  185.  
  186.                       Oh NO!  /NOIDEA specified!
  187.  
  188.  
  189. If you are having technical problems with GDS, we want to know about it!
  190. Give us a call at (510) 449-9079.  We'll be happy to figure out why things
  191. aren't going well with your copy of GDS.  If you can't get a hold of us
  192. (like if it's Sunday morning at 4:00AM), try sending a FAX.  We'll get back
  193. to you as soon as possible.
  194.  
  195. Photodex Corporation
  196. 1781 Barcelona Street
  197. Livermore, CA  94550
  198.  
  199. (510) 449-9079 - Voice
  200. (510) 449-3519 - FAX
  201.  
  202. Thank you for your support.
  203. :::doDelTxt
  204. It is probably not a good idea
  205. to delete, rename or move the
  206. GDS.TXT file.  Try again.:::falo
  207. WARNING: Files found before /~L%d!  Max files left unchanged.
  208.  
  209. Try specifying the /~L<n> parameter near the top of the GDSUSER.CFG file.
  210.  
  211. Press a key.
  212. :::virt
  213. Virtual screen must be 1, 4, 8, 15, 16, or 24 bits
  214. :::noVirt
  215. Can't create virtual file
  216. :::noVidType
  217. Unable to detect video type
  218. :::prob
  219.  
  220. If you have problems configuring GDS, try
  221. giving us a call at (510) 449-9079.
  222. :::detect
  223. Detecting video hardware...:::ckVesa
  224.  
  225. Checking for VESA support...
  226. :::modeTst
  227. VIDEO MODE TEST FOR %s
  228. ───────────────────────────
  229. %s Mode: %dx%d, %ld colors
  230.  
  231. Press: [Enter] to test this graphics mode.
  232.        [Y] to accept mode without testing.
  233.        [N] to remove mode.
  234.  
  235.        [Esc] to cancel.
  236.  
  237. ** If the screen goes crazy, press [Enter] quickly. **:::modeOver
  238. VIDEO CONFIGURATION COMPLETE
  239.  
  240. Press [Enter] to save the configuration
  241. as default, or [Esc] to cancel without
  242. making any changes.:::modeOverwrite
  243. An existing CONFIG file already exists.
  244. Do you want to overwrite it?
  245.  
  246. Press [Y] or [N], or [Esc] to cancel.:::modeNo
  247. Ok.  The changes you have made will not be
  248. saved to the permanent configuration file,
  249. but they will remain active for the rest of
  250. your current GDS session.
  251.  
  252. Press any key to exit.:::palLock
  253.   The palette has been locked to the
  254.  best fit for the currently selected
  255. files.  To unlock the palette, choose
  256.   the 'Lock Palette' option again.
  257.  
  258.      Press any key to continue.:::help
  259. ABOUT GDS/PHOTODEX
  260. GDS %s- Copyright (c)1991-94 Photodex Corporation.  All rights reserved.
  261. ──────────────────────────────────────────────────────────────────────────────
  262.    Photodex Corporation        CompuServe:  74274,3222 (GO GRAPHSUP)
  263.    1781 Barcelona Street         Internet:  photodex@netcom.com
  264.    Livermore, CA  94550
  265.    (510) 449-9079 Voice        Order Line:  (510) 449-9079  9AM-5PM PST
  266.    (510) 449-3519 Fax                        GDS is $39.95 (US funds)
  267. ──────────────────────────────────────────────────────────────────────────────
  268. Usage:    GDS [options] [files]
  269.  
  270.    [options] can be any command line options (see "Help" menu for details.)
  271.              Any command line parameters can be put into a configuration
  272.              file (see "Configuration Options" in the "Help" menu.)
  273.  
  274.      [files] can be any number of file and/or path specifications
  275. ──────────────────────────────────────────────────────────────────────────────
  276. Examples:
  277.           GDS                       -start GDS normally
  278.  
  279.           GDS /S /Z150              -do slideshow with 1.5 second delay
  280.                                      between frames
  281.  
  282.           GDS c:\gifs c:\jpegs      -start GDS using files from the c:\gifs
  283.                                      and c:\jpegs directories:::NoPrt
  284. This GDS trial version does not include printer
  285. drivers to print graphics.  The enhanced versions
  286. print 300dpi graphics fitted to an 8½x11" page in
  287. both portrait and landscape modes.  GDS prints on
  288. HP LaserJet and DeskJet printers, and is known to
  289. work with some true PCL compatible printers.
  290.  
  291.              Photodex
  292. Order Line:  (510) 449-9079   GDS is $39.95
  293.                              VISA/MC/AMEX OK
  294. FAX Orders:  (510) 449-3519
  295.   (please use printed form for FAX orders):::NoShell
  296. This version of GDS does not support shelling to
  297. DOS.  Enhanced versions support shelling.  If you
  298. need the ability to shell to DOS, call us.
  299.  
  300.              Photodex
  301. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  302.                              VISA/MC/AMEX Ok
  303. FAX Orders:  (510) 449-3519
  304.   (please use printed form for FAX orders):::Free25
  305. This GDS trial version cannot write images which
  306. have been 'color reduced' from more than 8 bits per
  307. pixel.  The enhanced (registered) version of GDS is
  308. responsible for some of the best looking graphics
  309. files in the world, and is available now.
  310.  
  311.              Photodex
  312. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  313.                              VISA/MC/AMEX Ok
  314. FAX Orders:  (510) 449-3519
  315.   (please use printed form for FAX orders):::NoValConv
  316. No graphics files selected to convert.
  317.  
  318. Put the file cursor on a file, or
  319. select files to convert by using the
  320. mouse or spacebar.:::NoBatch
  321. This GDS trial version cannot handle batch
  322. conversions.  The registered version easily
  323. converts up to 2,700 files in a single batch,
  324. and can do it from the command line as well.
  325. To get these and other powerful features,
  326. you need to call us.
  327.  
  328.              Photodex
  329. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  330.                              VISA/MC/AMEX Ok
  331. FAX Orders:  (510) 449-3519
  332.   (please use printed form for FAX orders):::NoAdd25
  333. This GDS trial version handles up to 25 files.
  334. The file list already has 25 files, so another
  335. file cannot be added.  The enhanced version
  336. easily handles over 2,700 files in any number
  337. of paths.  To get this function, you should
  338. call us with your order.
  339.  
  340.              Photodex
  341. Order Line:  510-449-9079    GDS is $39.95
  342.                              VISA/MC/AMEX OK
  343. FAX Orders:  510-449-3519
  344.   (please use printed form for FAX orders):::NoReduce
  345. This GDS trial version cannot color reduce true color
  346. (24 bit) pictures, or convert pictures to the JPEG
  347. format.  GDS is responsible for some of the highest
  348. quality 256 color images in the world.  Get GDS,
  349. and get the best color reduction around.
  350.  
  351.              Photodex
  352. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  353.                              VISA/MC/AMEX Ok
  354. FAX Orders:  (510) 449-3519
  355.   (please use printed form for FAX orders):::conNoV
  356. Unable to create virtual file.
  357.  
  358. (name=%s)
  359.  
  360. Press any key.:::conNoVText
  361. Unable to create virtual file (%s).
  362.  
  363. :::conAb
  364. Aborted by pressing [ESC].
  365.  
  366. Press any key.:::conAbText
  367. Aborted by pressing [ESC].
  368. :::batchFile
  369. You have files selected for a batch
  370. file operation.  This trial version
  371. only processes one file at a time.
  372.  
  373. For more information about getting the
  374. enhanced version of GDS, see "How to
  375. Order GDS" in the "Help" menu.
  376.  
  377. Press any key.:::manDead
  378. :::manMaster
  379. hlConfTop
  380.  hlConfPU
  381.  hlConfInst
  382.  hlConfLaptop
  383.  hlConfVideo
  384.  hlConfRept
  385.  hlConfCrash
  386.  hlConfATI
  387.  hlConfDiamond
  388.  hlConfOrchid
  389.  hlConfTest
  390.  hlConfFile
  391. hlFileList
  392. hlHowToSelect
  393. hlHowToView
  394.  hlViewModeCommands
  395.   hlVMCZoomOMatic
  396.   hlVMCColorLevel
  397.   hlVMCContrast
  398.   hlVMCBrightness
  399.   hlVMCHue
  400.   hlVMCScale
  401.   hlVMCArrow
  402.   hlVMCKeyboardPan
  403.   hlVMCSharp
  404.   hlVMCQuote
  405. hlHowToSlideshow
  406.  hlHowToCLSlideshow
  407. hlHowToCatalog
  408.  hlHowToCLCatalog
  409.  hlBBS
  410. hlHowToConvert
  411.  hlFileConvert
  412.  hlViewWrite
  413.  hl/@C
  414. manMenus
  415.  hlFileMenu
  416.   hlFileMenuCopy
  417.   hlFileMenuMove
  418.   hlFileMenuRename
  419.   hlFileMenuHide
  420.   hlFileMenuDelete
  421.   hlFileMenuSubdirs
  422.   hlFileMenuJump
  423.   hlFileMenuPrint
  424.   hlFileMenuShell
  425.   hlFileMenuExit
  426.  hlViewMenu
  427.   hlViewMenuSlideshow
  428.   hlViewMenuCatalog
  429.   hlViewMenuDithering
  430.   hlViewMenuAntialias
  431.   hlViewMenuBeep
  432.   hlViewMenuComment
  433.   hlViewMenuCatalogStyle
  434.   hlViewMenuCenterSlideshow
  435.  hlDisplayMenu
  436.   hlDisplayMenuShow
  437.   hlDisplayMenuSort
  438.  hlConvMenu
  439.   hlConvBMP1
  440.   hlConvBMP4
  441.   hlConvBMP8
  442.   hlConvBMP24
  443.   hlConvCUT1
  444.   hlConvCUT4
  445.   hlConvCUT8
  446.   hlConvGIF1
  447.   hlConvGIF4
  448.   hlConvGIF8
  449.   hlConvLBM1
  450.   hlConvLBM4
  451.   hlConvLBM8
  452.   hlConvPCX1
  453.   hlConvPCX4
  454.   hlConvPCX8
  455.   hlConvRIX4
  456.   hlConvRIX8
  457.   hlConvTGA15
  458.   hlConvTGA24
  459.   hlConvTIF1
  460.   hlConvTIF4
  461.   hlConvTIF8
  462.   hlConvTIF24
  463.   hlConvJPG24
  464.   hlConvWPG1
  465.   hlConvWPG4
  466.   hlConvWPG8
  467.   hlConvANSI
  468.  hlScanMenu
  469.  hlSetupMenu
  470.   hlSetupMenuConf
  471.   hlSetupMenuSystem
  472.   hlSetupMenuPrintColor
  473.   hlSetupMenuPrintPort
  474.   hlSetupMenuText
  475.  hlHelpMenu
  476.  hlResMenu
  477.  hlAutoLockMenu
  478.  hlMouseMenu
  479.  hlPaletteMenu
  480.   hlLimitPal
  481.   hlFetchPal
  482.   hlLockPal
  483. hlViewModeMenu
  484.  hlViewModeMenuFile
  485.   hlVMMFSaveANS
  486.   hlVMMFSaveGIF
  487.   hlVMMFSaveLBM
  488.   hlVMMFSavePCX
  489.   hlVMMFSaveBMP
  490.   hlVMMFSaveRIX
  491.   hlVMMFSaveTIF
  492.   hlVMMFSaveTGA
  493.   hlVMMFSaveJPG
  494.   hlVMMFSetCrop
  495.   hlVMMFResetCrop
  496.   hlVMMFFileInfo
  497.   hlVMMFQuit
  498.  hlViewModeMenuEdit
  499.   hlVMMERotate
  500.   hlVMMEFlipHorz
  501.   hlVMMEFlipVert
  502.   hlVMMEPan
  503.   hlVMMEReset
  504.  hlViewModeMenuColor
  505.   hlVMMCGray
  506.   hlVMMCMax
  507.   hlVMMCInvert
  508.   hlVMMCResetColor
  509.   hlVMMCResetAll
  510.  hlViewModeMenuSize
  511.   hlVMMSFit
  512.   hlVMMSSetZoom
  513.   hlVMMSDoubleX
  514.   hlVMMSDoubleY
  515.   hlVMMSDoubleXY
  516.   hlVMMSHalfX
  517.   hlVMMSHalfY
  518.   hlVMMSHalfXY
  519.   hlVMMSCenter
  520.   hlVMMSReset
  521.  hlViewModeMenuPrint
  522.   hlVMMPPrint
  523.  hlViewModeMenuRes
  524. manAppendix
  525.  hlTrialVer
  526.   hlDiff
  527.   hlLicensing
  528.  hlViewTheory
  529.  hlCmdAlpha
  530.   hl/!
  531.   hl/A
  532.   hl/B
  533.   hl/C
  534.   hl/D
  535.   hl/E
  536.   hl/F
  537.   hl/G
  538.   hl/H
  539.   hl/I
  540.   hl/I
  541.   hl/K
  542.   hl/L
  543.   hl/LAPTOP
  544.   hl/M
  545.   hl/N
  546.   hl/NOCGA
  547.   hl/NOEGA
  548.   hl/NOHERC
  549.   hl/NOMONO
  550.   hl/NOVESA
  551.   hl/NOIDEA
  552.   hl/O
  553.   hl/OK
  554.   hl/P
  555.   hl/Q
  556.   hl/QUIET
  557.   hl/R
  558.   hl/S
  559.   hl/T
  560.   hl/U
  561.   hl/V
  562.   hl/W
  563.   hl/X
  564.   hl/Z
  565.   hl/#
  566.   hl/=
  567.   hl/~0
  568.   hl/~A
  569.   hl/~B
  570.   hl/~E
  571.   hl/~F
  572.   hl/~G
  573.   hl/~J
  574.   hl/~K
  575.   hl/~L
  576.   hl/~M
  577.   hl/~O
  578.   hl/~R
  579.   hl/~T
  580.   hl/~Z
  581.   hl/<vid>
  582.   hl/512
  583.   hl/1M
  584.   hl@<file>
  585.   hl/@C
  586.  hlCmdVH
  587.  hlRev
  588.  hlGlossary
  589. :::manMenus
  590. Using GDS File List Menus
  591.  
  592. The file display of GDS has pull-down menus at the top of the text screen as
  593. well as the bottom.  The most used menus are at the top and the less
  594. commonly used (and more intricate) menus are at the bottom.
  595.  
  596. To activate a menu, simply click on the menu name with a mouse and drag the
  597. mouse down (or up) until the desired menu option is highlighted).  Release
  598. the mouse button to select the menu option.
  599.  
  600. If you are using a keyboard, you can use an "Alt" key combination to activate
  601. each menu.  Each menu has a highlighted letter, which can be typed as an "Alt"
  602. key combination to activate the menu.  Use the arrow keys to move the
  603. selection bar up and down until the desired option is highlighted.  Press the
  604. [Enter] key to select the menu option.
  605. :::manAppendix
  606. APPENDICES
  607. :::helpTop
  608. GDS Hypertext Help System
  609.  
  610.   Quick Reference
  611.   hlHowToViewHow to View Images        Welcome to GDS's built-in hypertext help
  612.   hlHowToSlideshowHow to Play Slideshows    system.  Use the [Tab] and [Shift-Tab] keys
  613.   hlHowToCatalogHow to Create Catalogs    or the mouse to highlight words and phrases
  614.   hlHowToConvertHow to Convert Images        displayed in bright white.
  615.   hlTrialVerGDS Trial Version
  616.                 For instructions on how to use this help
  617.   Detailed Information        system, press the hlHelpF1] key or hlHelpclick here.
  618.   hlFileListHow the File List Works
  619.   hlHowToSelectHow to Select Files
  620.   hlViewTheoryHow GDS Processes Images
  621.   hlConfTopGDS Configuration Info        Other Information
  622.                     hlFormatsSupported Formats
  623.   Menus & Commands            hlLicensingCD-ROM Licensing Info.
  624.   hlMenusMain File Menus            hlLegalCopyright and Legal Info.
  625.   hlViewModeMenuView Mode Menus            hlPhotodexPhotodex Corporation
  626.   hlViewModeCommandsView Mode Commands            hlOrderOrdering GDS
  627.                     hlOFrmOrder Form
  628.   Lists and Tables            hlUpgradeGDS Upgrades
  629.   hlCmdTopCommand Line Parameters
  630.   hlRevGDS Revision History            hlASPASP Ombudsman Statement (READ THIS!)
  631.   hlGlossaryGlossary of Computer Terms
  632. :::hlASP
  633. Photodex ASP Membership
  634.  
  635. hlPhotodexPhotodex Corporation is a member of the Association of Shareware
  636. Professionals (ASP).  ASP wants to make sure that the shareware principle
  637. works for you.  If you are unable to resolve a shareware-related problem
  638. with an ASP member by hlPhotodexcontacting the member directly, ASP may be able to
  639. help.  The ASP Ombudsman can help you resolve a dispute or problem with an
  640. ASP member, but does not provide technical support for members' products.
  641. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI
  642. 49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via CompuServe
  643. Mail to ASP Ombudsman 70007,3536.
  644. :::hlDistrib
  645. GDS Worldwide Distributors
  646.  
  647. United States        Photodex Corporation        (510)449-9079 - Voice
  648.             1781 Barcelona St.        (510)449-3519 - FAX
  649.             Livermore, CA  94550        photodex@netcom.com
  650.  
  651.  
  652. Distributor Inquiries Welcome; be prepared to FAX corporate backgrounder.
  653. :::hlLicensing
  654. GDS for CD-ROM (View-CD) Licensing Information
  655.  
  656. Special versions of GDS are available for licensing directly from hlPhotodexPhotodex.
  657. If you are a CD-ROM publisher, or would like to include GDS on a CD-ROM
  658. product of any kind, please contact Photodex and ask for the GDS for CD-ROM
  659. licensing information package.  It is about ten pages long, includes all
  660. relevant information about what it is, how it works, instructions on
  661. implementation, and a complete copy of the licensing agreement and terms.
  662. The fastest way to get this information is via FAX.
  663.  
  664. Briefly, the CD-ROM version of GDS is a fully functional standard registered
  665. version of GDS which requires the manufacturer's CD-ROM to be loaded in order
  666. to run.  All GDS for CD-ROM end-users are given the option to register a
  667. standard version since GDS is shareware.
  668.  
  669. If you are a CD-ROM publisher, GDS is the best of both worlds.
  670.  
  671. See Also
  672.     hlPhotodexContacting Photodex
  673.     hlLegalLegal Information
  674.  
  675. :::hlLegal
  676. Copyright and Legal Information
  677.  
  678. Copyright (c)1991-95 Photodex Corporation.  All rights reserved.
  679.  
  680. The GDS program, overlay files, help files, documentation, configuration
  681. files, graphics files and all other files are the property of Photodex
  682. Corporation.
  683.  
  684. If you have the shareware hlTrialVertrial version, you can use the product for a
  685. reasonable trial period of up to 21 days, after which time you must not use
  686. GDS unless you have purchased an enhanced version.
  687.  
  688. Related Topics
  689.     hlTrialVerGDS Trial Version
  690.     hlOrderOrdering GDS
  691.     hlLicensingGDS for CD-ROM Licensing
  692.     hlPhotodexPhotodex Corporation
  693.  
  694. :::hlFileList
  695. Using GDS File List
  696.  
  697. The center section of the screen is the File List.  The first items in the
  698. File List are normally the directories that can be reached from the current
  699. directory.  Directories are noted by the name being enclosed in pointed
  700. brackets: <dir> The parent directory is: <..>.  The current directory is not
  701. listed.  In some cases directories may not appear in the File List.  If you
  702. start GDS with a number of paths specified on the command line GDS will not
  703. display the directory tree in the File List.
  704.  
  705. After the directories GDS lists graphics files in the current directory (or
  706. specified path) that can be displayed.  Double click on a filename to enter
  707. View Mode and display the image.
  708.  
  709. The file display of GDS has pull-down menus at the top of the text screen as
  710. well as the bottom.  The most used menus are at the top and the less
  711. commonly used (and more intricate) menus are at the bottom.
  712.  
  713. To activate a menu, simply click on the menu name with a mouse and drag the
  714. mouse down (or up) until the desired menu option is highlighted).  Release
  715. the mouse button to select the menu option.
  716.  
  717. If you are using a keyboard, you can use an "Alt" key combination to activate
  718. each menu.  Each menu has a highlighted letter, which can be typed as an "Alt"
  719. key combination to activate the menu.  Use the arrow keys to move the
  720. selection bar up and down until the desired option is highlighted.  Press the
  721. [Enter] key to select the menu option.
  722.  
  723. Related Topics
  724.     hlHowToSelectSelecting Files
  725.     hlMenusMain File MenusmanMenus 
  726.  
  727. :::hlUpgrade
  728. GDS Upgrades
  729.  
  730. Special upgrade pricing is available for all registered GDS users.
  731.  
  732. Upgrade
  733.  Price        If you purchased GDS...
  734. -------        -----------------------
  735. $29.95+s/h    ...1.XX
  736.  
  737. $10.00        ...2.XX within the last calandar year.
  738. $29.95+s/h    ...2.XX more than one year ago.
  739.  
  740. $10.00        ...3.XX within the last six months.
  741. $29.95+s/h    ...3.XX within the last six months.
  742.  
  743. (call)        ...any version of GDS Professional
  744.  
  745. Shipping/handling charges are $3.00 for First Class Mail within the
  746. continental United States.  Other shipping charges apply for ALL OTHER
  747. SHIPPING DESTINATIONS.  For specific shipping prices, please call
  748. hlPhotodexPhotodex at (510) 449-9079.
  749.  
  750. $10.00 upgrade prices include First Class Mail within the continental
  751. United States.  Other shipping charges apply for other destinations.
  752. Please call for exact shipping amounts.
  753.  
  754.  
  755. :::hlOrder
  756. How to Order GDS
  757.  
  758. If you have already purchased a copy of GDS, you are eligible to receive
  759. special upgrade pricing.  See hlUpgradeGDS Upgrades.
  760.  
  761. By ordering GDS you get an enhanced version on 3.5" disk, a brief manual, the
  762. right to use GDS as much as you want, and special low upgrade rates for
  763. future versions of GDS.
  764.  
  765. To order GDS with a VISA, MasterCard or American Express, just call hlPhotodexPhotodex
  766. at (510) 449-9079 and have your card number handy.
  767.  
  768. The standard user version of GDS costs $39.95 plus shipping/handling and
  769. California state tax (if you are within California).
  770.  
  771. NOTE: We use your FULL NAME and VOICE PHONE NUMBER as your customer ID.  Your
  772. name and number will appear in your copy of GDS, but will NOT be used for any
  773. other purpose.  THERE ARE NO EXCEPTIONS.
  774.  
  775. To order GDS via mail or FAX, print out the hlOFrmPurchase Order/Registration Form
  776. and fill it out.  If ordering by FAX, please FAX the completed order form
  777. including the appropriate shipping amounts to hlPhotodex(510) 449-3519 -- no cover page
  778. is necessary.
  779.  
  780. If you prefer mailing, put the order form in a stamped envelope including a
  781. check or money order made payable to hlPhotodexPhotodex, and mail to hlPhotodexPhotodex:
  782.  
  783.       Photodex Corporation
  784.       1781 Barcelona Street
  785.       Livermore, CA  94550
  786.  
  787. Orders are usually processed within one business day except major holidays.
  788. UPS Ground shipping or mail is included.  Expedited and international shipping
  789. is extra.  Check orders must be drawn on a United States bank in U.S. funds.
  790. Orders received without proper international shipping charges will be returned
  791. postage due.
  792.  
  793. IF YOU ARE NOT IN THE UNITED STATES:  Call, FAX, E-Mail or write us to find
  794. out what you should be charged for shipping.  If the shipping amount is not
  795. correct on your order, your order will be returned postage due.
  796.  
  797.  
  798. :::hlPhotodex
  799. Photodex Corporation Information
  800.  
  801. Photodex has been a software developer and publisher since 1987.  The
  802. information in this section is subject to change without notice.
  803. 
  804. Address:
  805.     Photodex Corporation
  806.     1781 Barcelona Street
  807.     Livermore, CA  94550
  808.  
  809. Phones:
  810.     Voice    (510) 449-9079    (order line)
  811.     FAX    (510) 449-3519
  812.  
  813. E-Mail:
  814.     Internet    photodex@netcom.com
  815.     CompuServe    74274,3222
  816.     America Online    Photodex
  817.     Prodigy        Photodex
  818. :::hlAbout
  819. About GDS
  820.  
  821. GDS - Copyright(c)1991-95 hlPhotodexPhotodex Corporation.  All rights reserved.
  822.  
  823. GDS is a file viewer and cataloger.  It helps you manage image files.  It
  824. is "ShareWare", not "FreeWare", which means you must pay for it if you
  825. want to keep using it.  When you buy GDS, you also get the right to use it
  826. for as long as you like, a printed manual, several enhanced features, and
  827. the option to upgrade to future releases at greatly reduced rates.
  828.  
  829. See also
  830.     helpTopHypertext Help
  831.     hlOrderOrdering GDS
  832.  
  833.  
  834. :::hlExmp
  835. Example of Hyptertext Link
  836.  
  837. This reference is an example of the hypertext linking in GDS's on-line
  838. Hypertext Reference.  Any time you see a highlighted word, you can click on
  839. it to get more information.
  840.  
  841. Press the [Esc] key on the keyboard to exit back to the previous screen.
  842.  
  843.  
  844. :::hlCmdTop
  845. Command Line Parameters
  846.  
  847.   hlCmdAlphaAlphabetical List
  848.   hlCmdVHSpecifying Video Hardware
  849.   hlCmdCatCatalog Parameters
  850.  
  851.  
  852. :::hlCmdCat
  853. Catalog Parameters
  854.  
  855. The following is a list of command line parameters which are especially
  856. useful for creating catalogs from the command line.  If you wish to fully
  857. understand the capabilities of GDS's command line catalogs, look through
  858. these command line parameters.
  859.  
  860.     hl/A/A    Antialiasing level
  861.     hl/D/D    Dithering level
  862.     hl/G/G    Graphics resolution
  863.     hl/L/L    Catalog label control
  864.     hl/M/M    Optimized palette color limit
  865.     hl/N/N    New file name template
  866.     hl/O/O    Sort yes/no switch
  867.     hl/P/P    Set number of thumbnails across/start auto catalog
  868.     hl/Q/Q    Catalog logo placement control
  869.     hl/U/U    Catalog border control
  870.     hl/W/W    Set first file number to write
  871.     hl/~A/~A    Set catalog style
  872.     hl/~G/~G    Force optimized grayscale palettes
  873.     hl/~M/~M    Set JPEG quality level
  874.     hl/~O/~O    Set file sort type
  875.     hl/~R/~R    Force 1:1 aspect ratio
  876.     hl/~T/~T    Set catalog output file format
  877.     hl@<file>@<file>    Read file list from file
  878.  
  879. Related Topics
  880.     hlHowToCLCatalogCatalogs from the Command Line
  881.     hlBBSCataloging a BBS
  882.  
  883. :::hlCmdVH
  884. Video Hardware Parameters
  885.  
  886. The following is a list of valid video hardware types to be used to force
  887. GDS to assume it has certain video hardware.  See hl/<vid>/<vid>.
  888. 
  889.  /AHEAD        Ahead Systems 'A' chipset
  890.  /AHEADB    Ahead Systems 'B' chipset
  891.  /ATI        ATI VGA Wonder
  892.  /CGA        CGA
  893.  /CHIPS        Early Chips & Technologies chipsets
  894.  /CIRRUS    Early Cirrus Logic chipsets
  895.  /CL54        Cirrus Logic 54xx chipsets
  896.  /EGA        Standard EGA
  897.  /EVEREX    Early Everex SVGA's
  898.  /EV634        Everex Viewpoint Premium VGA
  899.  /F1280        Orchid Farenheit 1280
  900.  /GENOA        Genoa 6600 series (6100, 6200, 6300, 6400, 6600)
  901.  /HERC        Hercules mono only
  902.  /OAK        Oak Technologies
  903.  /PARA        Paradise (Western Digital) chipsets
  904.  /SS24X        Diamond Speedstar 24X (NOT Speedstar 24!)
  905.  /ST64        Diamond Stealth 64
  906.  /STEALTH    Diamond Stealth VRAM
  907.  /STPRO        Diamond Stealth PRO
  908.  /TRIDNT    Trident TVGA / ATI Prism Elite
  909.  /TSENG        Tseng Laboratories ET-3000 chipsets
  910.  /TSENG4    Tseng Laboratories ET-4000 chipsets
  911.  /VESA        VESA (avoids autodetection)
  912.  /VGA        Standard VGA
  913.  /VID7        Video 7 VEGA Deluxe, 1024i, VRAM VGA
  914.  
  915. Related Parameters
  916.     hl/<vid>/<vid>    Force Video Hardware Type
  917.     hl/LAPTOP/LAPTOP    Use on some laptops to avoid standard modes
  918.     hl/NOCGA/NOCGA    Ignore CGA modes (useful for laptops/notebooks)
  919.     hl/NOEGA/NOEGA    Ignore EGA modes (useful for laptops/notebooks)
  920.     hl/NOHERC/NOHERC    Ignore Hercules mono (useful for laptops/notebooks)
  921.     hl/NOMONO/NOMONO    Ignore all mono modes (restricts modes to color)
  922.     hl/NOVESA/NOVESA    Do NOT trust manufacturer's VESA BIOS information
  923.  
  924.  
  925. :::hlCmdAlpha
  926. Alphabetical Command Line Parameter List
  927.  
  928.     *NOTE:  Command line parameters to specify video hardware are not
  929.         shown here. See hlCmdVH/<vid> for more information.
  930. 
  931. hl/! /!     Beep when image view complete
  932. hl/A /A     Antialiasing level
  933. hl/B /B     Text mouse cursor mode
  934. hl/C /C     Palette DAC chip control (SuperEGA's may need this)
  935. hl/D /D     Dithering level
  936. hl/E /E     Image fit mode
  937. hl/F /F     Default file display options
  938. hl/G /G     Default graphics resolution
  939. hl/H /H     Help
  940. hl/I /I     Interlaced GIF fill mode
  941. hl/K /K     Display GIF comments after view
  942. hl/L /L     Catalog label control
  943. hl/LAPTOP /LAPTOP Use on some laptops to avoid certain video modes
  944. hl/M /M     Optimized palette color limit
  945. hl/N /N     New file name template
  946. hl/NOCGA /NOCGA     Ignore CGA modes
  947. hl/NOEGA /NOEGA     Ignore EGA modes
  948. hl/NOHERC /NOHERC Ignore Hercules mono mode
  949. hl/NOMONO /NOMONO Ignore all mono modes
  950. hl/NOVESA /NOVESA Do NOT trust manufacturer's VESA BIOS information
  951. hl/NOIDEA /NOIDEA Prints phone number to call when you're confused
  952. hl/O /O     Sort order control
  953. hl/OK /OK     Prevent recurring configuration
  954. hl/P /P     Create catalogs from command line
  955. hl/Q /Q     Catalog logo placement control
  956. hl/QUIET /QUIET     Disable opening screen
  957. hl/R /R     Resolution 'Lock' mode
  958. hl/S /S     Play slideshow
  959. hl/T /T     Text mode control
  960. hl/U /U     Catalog border control
  961. hl/V /V     File list vertical presentation option
  962. hl/W /W     Set first file number to write
  963. hl/X /X     Exit to DOS after slideshow
  964. hl/Z /Z     Slideshow delay
  965. hl/# /#     Set printer's filename
  966. hl/@C /@C     Convert files from command line
  967. hl/= /=     Control default palette gamma/process levels
  968. hl/~0 /~0     Force screen clear when setting video modes
  969. hl/~A /~A     Set catalog background style
  970. hl/~B /~B     Set slideshow centering mode
  971. hl/~E /~E     Disable slideshow mode change for similar modes
  972. hl/~F /~F     Color reduction proximity elimination level
  973. hl/~G /~G     Force optimized grayscale palettes
  974. hl/~J /~J     Print in color
  975. hl/~L /~L     Set dynamic file list cache size
  976. hl/~M /~M     Set JPEG quality level
  977. hl/~O /~O     Set file sort mode
  978. hl/~R /~R     Assume aspect ratio of all catalog files to 1:1
  979. hl/~T /~T     Catalog output format control
  980. hl/~Z /~Z     Catalog output path control
  981. hl/<vid>/<vid>    Force Video Hardware Type
  982. hl@<file> @<file> Read file list from file
  983.  
  984.  
  985. :::hlRev
  986. Revision History
  987.  
  988. GDS is updated constantly in response to the changing environment of the
  989. computer industry.  Photodex intends to inform existing users of significant
  990. upgrades to GDS as an ongoing process.
  991.  
  992. This revision history is not intended to be extremely complete, but should
  993. indicate some of the major advances in the GDS functionality.  This list
  994. starts with the most recent revisions and continues backward in time.
  995.  
  996. Items marked with '■' are additions, improvements or changes which are
  997. better or comparable to previous versions.  Items marked with 'X' are known
  998. bugs in the listed version which may have been corrected in later versions.
  999.  
  1000. GDS 3.1d - minor release
  1001. ------------------------
  1002. NEW!  ■ Full support for Word Perfect Graphics files hlFormats(.WPG).
  1003.  
  1004. NEW!  ■ Full support for Media Cybernetics (HALO) files hlFormats(.CUT + .PAL).
  1005.  
  1006. NEW!  ■ Added full support for reading 4096 color (12-bit) Amiga HAM files.
  1007.  
  1008. NEW!  ■ Added full support for reading Windows Run-Length Encoded (.RLE)
  1009.     files.
  1010.  
  1011. NEW!  ■ Automatically detects and supports hlConfATIATI Mach 32 and Mach 64 cards.
  1012.  
  1013. NEW!  ■ Added support for 32 bit CMYK JPEG files.  GDS now converts CMYK
  1014.     information internally into RGB on the fly.  These files will appear
  1015.     as 24 bit files in the file list.
  1016.  
  1017. NEW!  ■ Added support for generic text files hlFormats(.TXT).  These files are viewed,
  1018.     converted and cataloged the same as ANSI hlFormats(.ANS) files. (View GDS.TXT
  1019.     in the file list!)
  1020.  
  1021.       ■ Optimized JPEG reader to increase speed and reduce code size.
  1022.  
  1023.       ■ Reduced file limit to 2,729 simultaneous files, increasing effective
  1024.     path limit.  If you do hit a path limit, please call us.
  1025.  
  1026.       ■ Added hl/~0/~0n parameter.  This flag can tell GDS to manually
  1027.     clear the screen when it sets graphics video modes.
  1028.  
  1029.       ■ Fixed bug causing "delete" prompt to stick on the same file when user
  1030.     types 'N'.
  1031.  
  1032. GDS 3.1c - minor release
  1033. ------------------------
  1034. NEW!  ■ ANSI text file support.  ANSI files are emulated as if they were
  1035.     graphics files, except for normal viewing, which is done in the
  1036.     current text mode.  When GDS does slideshows or catalogs, ANSI files
  1037.     are rendered into character mapped graphics files on the fly.  You
  1038.     can view a character mapped graphics rendition of an ANSI file by
  1039.     locking the resolution to a graphics mode and double clicking on the
  1040.     ANSI file in the file list.  Writing to ANSI files is a feature of
  1041.     GDS Professional and is not available in standard versions of GDS.
  1042.     Contact Photodex for more information.
  1043.  
  1044. NEW!  ■ GRASP and .FLI file support -- without previous memory limitations.
  1045.     GDS now flushes itself out to EMS, XMS and/or disk when playing .GL
  1046.     and .FLI files.  Make sure to put GRASPRT.EXE and QUICKFLI.EXE in the
  1047.     GDS directory and GDS will automatically view .GL and .FLI files with
  1048.     a double click.
  1049.  
  1050. NEW!  ■ Integrated hypertext help system (you are using it right now!)
  1051.  
  1052. NEW!  ■ Introduced complete on-line manual.  This first release has 74 pages
  1053.     with 199 separate sub-sections.
  1054.  
  1055. NEW!  ■ Automatically detects and supports Diamond Stealth 64 in all video
  1056.     resolutions.  Added hlCmdVH/ST64 to the available command line parameters,
  1057.     but since the Stealth 64 should remain very detectable, using hlCmdVh/ST64
  1058.     should never be necessary.
  1059.  
  1060. NEW!  ■ Configuration greatly improved.  The configuration process has been
  1061.     changed significantly, and should be capable of detecting modes which
  1062.     earlier versions of the configuration would have automatically
  1063.     rejected.  The operation of the configuration process is the same,
  1064.     except that GDS may support quite a few new video modes.
  1065.  
  1066. NEW!  ■ "DOS Shell" function added to registered version.  GDS swaps out of
  1067.     memory during DOS shell functions, using only a 7K for itself.  This
  1068.     enables you to do just about anything from within GDS.
  1069.  
  1070.       ■ Configuration file tag changed.  This will cause a reconfiguration on
  1071.     all systems, regardless of the state of the video hardware.  The
  1072.     reason for this is the improved video mode support and instant video
  1073.     memory test in this version.
  1074.  
  1075.       ■ Corrected problem deleting batches of files in registered version.
  1076.  
  1077.       ■ Corrected problem writing 16 color TIFF files.
  1078.  
  1079.       ■ Cirrus Logic: Added non-VESA video modes back into GDS.  This allows
  1080.     GDS to support non-VESA Cirrus Logic video BIOS's, even if the VESA
  1081.     support does not work reliably.
  1082.  
  1083.       X Fixed DOS error when logging to drive with unreadable disk.
  1084.  
  1085.       X Fixed memory leak when converting files requiring color reduction.
  1086.  
  1087.       X TIFF tag 321 can crash GDS, believed to be in .TIF files made using
  1088.     software bundled with HP Color ScanJets.  Later versions now ignore
  1089.     tag 321.  Fixed in 3.1d.
  1090.  
  1091.       X Command line batch conversions may not operate properly in registered
  1092.     versions.  This bug could be responsible for system crashes.  Fixed
  1093.     in 3.1d.
  1094.  
  1095.       X Problem with hlViewWrite"hlViewWrite" link in hypertext help and
  1096.     printed manual.  This problem sometimes caused the manual to be
  1097.     unprintable, and may have caused GDS to appear to crash when printing
  1098.     the manual.  Fixed in most versions of 3.1c (maintenance release) and
  1099.     formally released in 3.1d.
  1100.  
  1101.       X Problem with 15 and 16 bit modes exists when using a point-and-shoot
  1102.     catalog to view images.  When returning from selected image, catalog
  1103.     screen may be stretched horizontally.  Fixed in 3.1d.
  1104.  
  1105. GDS 3.1b - minor release
  1106. ------------------------
  1107. NEW!  ■ XMS support added for virtual files.  Virtual file operations are now
  1108.     almost as fast as direct screen functions, but can be done in any
  1109.     output resolution, regardless of the available video hardware.
  1110.  
  1111. NEW!  ■ 3-D style catalog screens possible.  Note that this changes the
  1112.     definition of the hl/~A/~A command line parameter.
  1113.  
  1114.       ■ Corrected problem reading certain grayscale JPEG files.
  1115.  
  1116.       ■ Corrected problem reading certain sized 24 bit images when reducing
  1117.     size.  This fix enables GDS to read files which are up to 3072 pixels
  1118.     wide, which is the same as horizontal PhotoCD resolution images.
  1119.  
  1120.       ■ Introduced undocumented hlVMCQuote"Quote-O-Matic" function into view mode.
  1121.  
  1122.       ■ Removed REGISTER.PRN from GDS in order to keep the size of GDS
  1123.     distribution files down.  REGISTER.PRN was an HP LaserJet version of
  1124.     the registration form.  Please use REGISTER.TXT or the help system to
  1125.     print a generic registration form.
  1126.  
  1127.       ■ Added FILE_ID.DIZ and READ.ME to GDS distribution files.  FILE_ID.DIZ
  1128.     is used by many BBS systems to automatically describe ZIP files.
  1129.  
  1130.       X Some problems with XMS virtual file caching have been reported.  Some
  1131.     file conversions can cause GDS to hang the machine, or cause color
  1132.     artifacts during color reduction.  Fixed in 3.1c.
  1133.  
  1134.       X Photodex has received reports of intermittent color artifacts when
  1135.     converting large batches of JPEG files into GIF format using the
  1136.     normal interface.  This may have been corrected with the XMS virtual
  1137.     file bug fix above.  Please bring any color artifacting to our
  1138.     attention immediately.
  1139.  
  1140. GDS 3.1a - minor release
  1141. ------------------------
  1142.       ■ Fixed problem with JPEG file list handling.  Some problems exist in
  1143.     GDS 3.1 which prevent .JPG files from appearing in the file list.
  1144.  
  1145.       ■ Configuration now allows swapping of the red and blue color bars for
  1146.     24 bit video modes.  When modes are displayed during configuration,
  1147.     the message "[S]wap Red & Blue" is displayed, with a red background
  1148.     behind the word "Red" and a blue background behind the word "Blue",
  1149.     so the user can tell if red and blue need to be swapped.
  1150.  
  1151.       ■ Added skew modification to configuration so video modes which have
  1152.     non-standard screen widths can be manually corrected.  If a video
  1153.     mode is radically skewed but displayed without flicker, then use the
  1154.     left and right arrow keys to try adjusting the skew.
  1155.  
  1156.       X Problems reading certain grayscale JPEG files.  Fixed in v3.1b.
  1157.  
  1158. GDS 3.1  - significant release
  1159. ------------------------------
  1160. NEW!  ■ GDS now reads and writes JPEG files.  Registered versions support a
  1161.     command line parameter to adjust the compression level for writing
  1162.     JPEG files.
  1163. 
  1164.       X Problem deleting batches of files correct in 3.1c.
  1165.  
  1166. GDS 3.0  - MAJOR RELEASE
  1167. ------------------------
  1168. NEW!  ■ Radically improved user interface.  GDS just got simpler and easier
  1169.     to use.
  1170.  
  1171. NEW!  ■ New "View Mode Pull-down Menus" allow switching resolutions without
  1172.     exiting to the file list.
  1173.  
  1174. NEW!  ■ On-line help menu and registration form printout.
  1175.  
  1176. NEW!  ■ GDS is now distributed by Photodex.  Photodex is owned by the author
  1177.     of GDS, and has assumed control of all distribution of GDS.  Please
  1178.     direct your inquiries regarding GDS to:
  1179.  
  1180.         Photodex            (510) 449-9079 - Voice
  1181.         1781 Barcelona Street        (510) 449-3519 - FAX
  1182.         Livermore, CA  94550       photodex@netcom.com - internet
  1183.  
  1184.       ■ Cirrus Logic 54xx chipset video hardware now detected and supported.
  1185.  
  1186.       X Problems writing 16 color TIFF files corrected in v3.1c.
  1187. 
  1188.       X Problems reading large 24 bit images and size reducing corrected in
  1189.     v3.1b.
  1190. 
  1191. *NOTE:    Versions earlier than listed here are not officially tracked by this
  1192.     revision history.  If you have a version of GDS earlier than 3.0,
  1193.     then it is safe to assume that the product has changed so much that
  1194.     it might as well be a different product.
  1195.  
  1196.  
  1197. :::hlGlossary
  1198. Glossary
  1199.  
  1200. "antialiasing"
  1201.     The process of smoothing color values together when an image is
  1202.     resized.  Most graphics viewers do not bother antialiasing images
  1203.     because the code is much easier to write.
  1204.  
  1205. "bit"
  1206.     The smallest element of logic, which is either a 1 or a 0.  Bits are
  1207.     combined together to represent larger numbers, like bytes.
  1208.  
  1209. "bork"
  1210.     A bork (or borking) is when you say something that you weren't
  1211.     supposed to say while logged into an on-line chat system.
  1212.     For Example: "I borked."
  1213.  
  1214. "byte"
  1215.     A set of eight bits which can represent 256 different values.  If used
  1216.     to represent a number which starts at 0 and cannot be less than zero
  1217.     (unsigned), a byte can represent a value from 0 to 255.  If signed, a
  1218.     byte represents a value from -128 to 127.  Characters can be thought
  1219.     of as bytes since each character takes one byte to store without
  1220.     specialized compression.
  1221.  
  1222. "chipset"
  1223.     A set of microchips integrated into a piece of computer hardware
  1224.     which is used to accomplish some standardized task.  Video chipsets
  1225.     are integrated into common video cards in order to generate the video
  1226.     signals required to drive a monitor.  Video card manufacturers rarely
  1227.     design their own chipsets anymore, but instead design their video
  1228.     cards around generalized chipsets available from companies like
  1229.     Cirrus Logic, Oak Technologies, S3, Tseng Laboratories and Weitek.
  1230.     Most of the video detection in GDS is specific to chipset detection
  1231.     rather than video card detection, since the chipset is usually the
  1232.     same across many video cards.
  1233.  
  1234. "color reduction"
  1235.     The process of reducing the number of colors used to display a digital
  1236.     image.  The term "color reduction" is usually used to describe the
  1237.     process used to convert images from 15, 16 or 24 bits per pixel to
  1238.     eight or fewer bits per pixel.  This is usually done because most
  1239.     color computer systems have either 16 or 256 color displays, which
  1240.     provide 4 and 8 bits per pixel, respectively.  GDS uses Photodex's
  1241.     proprietary color reduction technology (developed for the professional
  1242.     photography industry), and produces the best color reduction
  1243.     available.  If you have doubts, please benchmark GDS color reduction
  1244.     against other software and prepare to be surprised.
  1245.  
  1246. "diffusion dither"
  1247.     See "Floyd/Steinberg dither" below.
  1248.  
  1249. "Floyd/Steinberg dither"
  1250.     A method of dithering (developed by Floyd and Steinberg) which
  1251.     approximates midtones over areas of pixels by choosing colors which
  1252.     equal the sum total of the immediate area's color value.  This
  1253.     specific type of dither is used in GDS because it is extremely fast.
  1254.     This dithering method is sometimes referred to as a "diffusion
  1255.     dither", although the term "stochastic dither" is more precise.
  1256.  
  1257. "GDS"
  1258.     This program; acronym for "Graphics Display System."
  1259.  
  1260. "HAM"
  1261.     "Hold and Modify", term used to describe an Amiga display mode which
  1262.     can display up to 4096 colors using only six bits per pixel.  The
  1263.     images are encoded such that 16 preset colors can be specified
  1264.     directly, and other colors must be generated by changing the red,
  1265.     green or blue content of following pixels one at a time.  HAM files
  1266.     are a subset of Electronic Arts' IFF specification.
  1267.  
  1268. "pel"
  1269.     See "pixel".
  1270.  
  1271. "pixel"
  1272.     Dot in a digital image.  The term comes from graphics experts
  1273.     abbreviating the term "picture cell" into this shorter slang term.
  1274.     Also- "pel".
  1275.  
  1276. "stochastic dither"
  1277.     See "Floyd/Steinberg dither" above.
  1278.  
  1279. "thumbnail"
  1280.     A small rendition of a larger graphics image.  GDS creates catalogs
  1281.     by creating arrays of thumbnails which are labeled with the filename
  1282.     and resolution of the original graphics image file.
  1283.  
  1284. "TIGA"
  1285.     A library standard which provides access Texas Instruments 32000 and
  1286.     34000 series graphics co-processors.  TIGA is nearly extinct since
  1287.     the recent release of many of the modern video co-processors.
  1288.  
  1289. "virtual file"
  1290.     A pool of memory or disk storage used to hold a large amount of
  1291.     temporary information.  In GDS, virtual files are used to create
  1292.     "virtual screens," which allow GDS to operate on graphics data even
  1293.     if the data cannot be displayed.  For example, virtual files make it
  1294.     possible for a monochrome machine with no graphics capabilities to
  1295.     perform image file conversions from the command line.
  1296.  
  1297. "virtual screen"
  1298.     A virtual file (see above) which contains data which is thought of
  1299.     as a screen because the data is in the same format as it would appear
  1300.     in memory on a video adapter.
  1301.  
  1302. "VRAM"
  1303.     Video RAM.  VRAM is specialized video RAM which can provide a very
  1304.     fast stream of data to the video output generator and still be used
  1305.     at the same time as if it were normal RAM.  This allows the computer
  1306.     to read and write from the video memory while the graphics image is
  1307.     being output to the monitor with very little performance loss.
  1308.  
  1309.  
  1310. :::hlTrialVer
  1311. GDS Trial Version
  1312.  
  1313. The Trial Version of GDS is Shareware.  It is not free software.  It is
  1314. intended to be used for a trial period of up to 21 days.  This allows users
  1315. to test software for a reasonable time and pay only for what they use.
  1316.  
  1317. The GDS Trial Version may only be distributed in its original form, and at
  1318. no charge for the GDS software itself.  Modifying any of the program files
  1319. without permission from Photodex voids any right to redistribute copies.  The
  1320. Registered Version of GDS may not be redistributed without a written
  1321. distribution agreement with hlPhotodexPhotodex.
  1322.  
  1323. If you have been using the Trial Version for an extended period of time,
  1324. please register your copy today.
  1325.  
  1326. Related Topics
  1327.     hlDiffDifferences in GDS Versions
  1328.     hlOrderOrdering GDS
  1329.     hlOFrmGDS Order Form
  1330.     hlLegalCopyright and Legal Info.
  1331.     hlLicensingGDS for CD-ROM Licensing
  1332.  
  1333.  
  1334. :::hlDiff
  1335. Differences in GDS Versions
  1336.  
  1337. All versions of GDS do most functions that GDS users find valuable.  It is
  1338. somewhat unfair to consider GDS "cripple-ware" if you consider that what it
  1339. does do is more than most graphics viewers and converters do in the complete
  1340. versions.
  1341.  
  1342. The following enhancements are available in registered versions of GDS:
  1343.  
  1344.     hlOrderGDS ($39.95) Enhancements in Registered Version
  1345.     -----------------------------------------------
  1346.     Handles over 2,700 simultaneous files in any number of paths
  1347.     Prints in both color and monochrome (HP PCL compatible 300dpi)
  1348.     Supports batch and command line operation for common functions
  1349.     Writes super high quality 256 color images read from 24 bit images
  1350.     Converts to JPEG Format
  1351.     Complete JPEG Compression Control
  1352.     Provides Shelling to DOS
  1353.  
  1354. In addition, there is a version of GDS for BBS system operators and other
  1355. professionals.  The sysop (or professional) version provides hlScanMenuscanning,
  1356. conversion of any graphics file format into ANSI color text files, and some
  1357. very powerful command line parameters for batch functions including automatic
  1358. logo and automatic text insertion into catalogs.
  1359.  
  1360. Related Topics
  1361.     hlOrderOrdering GDS
  1362.     hlOFrmGDS Order Form
  1363.     hlLegalCopyright and Legal Info.
  1364.     hlTrialVerGDS Trial Version
  1365.  
  1366.  
  1367. :::hlMenus
  1368. Menu Options
  1369.  
  1370. hlFileMenuFile   hlViewMenuView   hlDisplayMenuDisplay   hlConvMenuConvert   hlScanMenuScan:Color   hlSetupMenuSetup   hlHelpMenuHelp
  1371.  
  1372.     Click on the menu you would like help with, or choose from the
  1373.     following list:
  1374.  
  1375.         hlFileMenuFile Menu
  1376.         hlViewMenuView Menu
  1377.         hlDisplayMenuDisplay Menu
  1378.         hlConvMenuConvert Menu
  1379.         hlScanMenuScan Menu (GDS Pro. Only)
  1380.         hlSetupMenuSetup Menu
  1381.         hlHelpMenuHelp Menu
  1382.  
  1383.         hlResMenuResolution Menu
  1384.         hlAutoLockMenuAuto/Lock Toggle Button
  1385.         hlPaletteMenuPalette Menu
  1386.         hlMouseMenuMouse Bits/Boxy Toggle Button
  1387.         hlViewMenuSlideshowQuick Slideshow Button
  1388.  
  1389.  
  1390.                             hlViewMenuSlideshow+-----Click Here----+
  1391.                             hlViewMenuSlideshow+---For Slideshow!--+
  1392. hlResMenuRes:####x###x###   hlAutoLockMenuAuto Selection   hlPaletteMenuPalette   hlMouseMenuMouse:Bits
  1393. :::hlFileMenu
  1394. File Menu
  1395.  
  1396. The following options are available in the File List File Menu:
  1397. 
  1398.     hlFileMenuCopyCopy File(s) to...    Ctrl-C
  1399.     hlFileMenuMoveMove File(s) to...    Ctrl-T
  1400.     hlFileMenuRenameRename File(s)...    Ctrl-R
  1401.     hlFileMenuHideHide File(s)        Ctrl-H
  1402.     hlFileMenuDeleteDelete File(s)        Ctrl-D
  1403.     ------------------------------
  1404.     hlFileMenuSubdirsSearch All Subdirs        
  1405.     hlFileMenuJumpJump to Path...        Ctrl-F
  1406.     ------------------------------
  1407.     hlFileMenuPrintPrint Portrait        
  1408.     hlFileMenuPrintPrint Landscape        
  1409.     ------------------------------
  1410.     hlFileMenuShellDOS Shell        Alt-J or Z
  1411.     ------------------------------
  1412.     hlFileMenuExitExit GDS           Esc
  1413.  
  1414.  
  1415. :::hlFileMenuCopy
  1416. File Menu: Copy Files
  1417.  
  1418. This menu item will copy a file or group of files to a different directory
  1419. while leaving the original files intact. hlHowToSelectSelect a file or group of files
  1420. from the File List and select Copy Files (or hit [Ctrl-C]) to start the
  1421. process. GDS will open a dialog box where the destination path for the
  1422. file(s) must be typed in.
  1423.  
  1424.  
  1425. :::hlFileMenuMove
  1426. File Menu: Move Files
  1427.  
  1428. This menu item will move a file or group of files to a different directory
  1429. and delete the original files. hlHowToSelectSelect a file or group of files from the File
  1430. List and select Move Files (or type [Ctrl-M]) to start the process. GDS will
  1431. open a dialog box where the destination path for the file(s) must be typed.
  1432.  
  1433.  
  1434. :::hlFileMenuRename
  1435. File Menu: Rename Files
  1436.  
  1437. This menu item will allow the name of a file to be changed. hlHowToSelectSelect a file
  1438. then select Rename Files (or type [Ctrl-R]) to start the process. GDS will
  1439. open a dialog box where the new filename must be entered.
  1440.  
  1441.  
  1442. :::hlFileMenuHide
  1443. File Menu: Hide Files
  1444.  
  1445. This menu item will remove a file or group of files from the File List
  1446. without deleting them. hlHowToSelectSelect a file or group of files from the File
  1447. List and select Hide Files (or type [Ctrl-H]) to hide the files. The hidden
  1448. files will not appear in the File List while working in the directory.
  1449.  
  1450.  
  1451. :::hlFileMenuDelete
  1452. File Menu: Delete Files
  1453.  
  1454. This menu item will delete a file or group of files from your drive or disk.
  1455. hlHowToSelectSelect a file or group of files from the File List and select Delete Files
  1456. (or type [Ctrl-D]) to start the process. GDS will open a dialog box for
  1457. confirmation of the Delete process.  Type "Y" to delete the file or "N" to
  1458. cancel the process.  NOTE: If you are deleting a batch of files and you are
  1459. absolutely sure you want them gone you can hold down the "Y" key to speed the
  1460. process.
  1461.  
  1462.  
  1463. :::hlFileMenuSubdirs
  1464. File Menu: Search Subdirectories
  1465.  
  1466. This menu item will start a search for graphics files in all subdirectories
  1467. of the current directory.  All valid files will be added to the File List.
  1468. By selecting this command you can scan an entire hard drive (make sure you
  1469. are in the root directory) or CD-ROM disc. You can easily catalog an entire
  1470. CD-ROM by using this command in conjunction with View Menu: Create Catalog.
  1471.  
  1472.  
  1473. :::hlFileMenuJump
  1474. File Menu: Jump to Path
  1475.  
  1476. Selecting Jump to Path from the File menu will open a window allowing any
  1477. number of paths to be entered. Wildcard characters (*) can be used in the
  1478. filenames but not the paths. Multiple paths can be entered but must be
  1479. separated by spaces.
  1480.  
  1481. This command can be particularly useful for CD-ROM catalogs, for limiting
  1482. file types displayed in the File List, or for adding files from another
  1483. directory to the File List.
  1484.  
  1485.  
  1486. :::hlFileMenuPrint
  1487. File Menu: Print Portrait or Landscape
  1488.  
  1489. These menu options will print the currently hlHowToSelectselected file in either portrait
  1490. (10" tall) or landscape (10" wide) mode on HP LaserJets, DeskJets and 100%
  1491. compatible PCL printer language printers.  Additionally, GDS will print in
  1492. color on the DeskJet 500C, 550C, 560C, and 1200C.  The correct port must be
  1493. selected in the Setup Menu: Printer On... section.
  1494.  
  1495. Note:  Printing graphics is supported in enhanced versions of GDS only.
  1496.  
  1497.  
  1498. :::hlFileMenuShell
  1499. File Menu: DOS Shell
  1500.  
  1501. This menu will exit to a DOS shell while leaving GDS in its current state.
  1502. [Alt-Z] and [Alt-J] will also exit to a DOS Shell. To return to GDS from
  1503. the DOS Shell type "exit".
  1504.  
  1505.  
  1506. :::hlFileMenuExit
  1507. File Menu: Exit GDS
  1508.  
  1509. Exits the fantastic world of GDS and leaves you wanting more!
  1510.  
  1511.  
  1512. :::hlViewMenu
  1513. View Menu
  1514.  
  1515. The following options are available in the File List View Menu:
  1516. 
  1517.     hlViewMenuSlideshowView Slideshow
  1518.     hlViewMenuCatalogCreate Catalog
  1519.     -------------------------
  1520.     hlViewMenuDitheringNo Dithering
  1521.     hlViewMenuDithering:2 Dithering
  1522.     hlViewMenuDithering:4 Dithering
  1523.     -------------------------
  1524.     hlViewMenuAntialiasAntialiasing Enabled
  1525.     hlViewMenuBeepBeep For View Complete
  1526.     hlViewMenuCommentAuto Show Comment Records
  1527.     hlViewMenuCatalogStyleBlack Catalogs
  1528.     hlViewMenuCatalogStyleWhite Catalogs
  1529.     hlViewMenuCatalogStyleGray/3D Catalogs
  1530.     hlViewMenuCenterSlideshowCenter Slideshow Images
  1531.  
  1532.  
  1533. :::hlViewMenuSlideshow
  1534. View Slideshow
  1535.  
  1536. This menu option starts a slideshow of the hlHowToSelectselected files.  If no files
  1537. are selected, a slideshow of all files in the file list is played.  You can
  1538. also start a slideshow by clicking in the rectangle at the lower left of the
  1539. main GDS file list screen labeled "Click here for SlideShow!"
  1540.  
  1541. Related Topics
  1542.     hlHowToSlideshowHow to Play a Slideshow
  1543.     hlHowToCLSlideshowSlideshows from the Command Line
  1544.  
  1545. Related Parameters
  1546.     hl/S/S    Play Slideshow
  1547.     hl/Z/Z    Set default delay between slides
  1548.     hl/E/E    Fit images to screen
  1549.  
  1550.  
  1551. :::hlViewMenuCatalog
  1552. Create Catalog
  1553.  
  1554. Selecting this menu option begins the catalog creation process for all
  1555. hlHowToSelectselected files.  If no files are selected, then all files in the file list
  1556. appear in the catalog.
  1557.  
  1558. Related Topics
  1559.     hlHowToCatalogHow to Create Catalogs
  1560.     hlHowToCLCatalogCatalogs from the Command Line
  1561.     hlBBSCataloging a BBS
  1562.  
  1563. :::hlViewMenuDithering
  1564. Dithering Method
  1565.  
  1566. This set of menu items sets the level of dithering when the number of colors
  1567. is reduced.  The default is 1:4 Dithering - the best available.  There may be
  1568. circumstances when a different level of dithering is preferred.
  1569.  
  1570. To change GDS's default dithering method, add hl/D/D<n> to hlConfFileGDSUSER.CFG.
  1571.  
  1572. Related Parameters
  1573.     hl/D/D    Change default dithering
  1574.  
  1575.  
  1576. :::hlViewMenuAntialias
  1577. Antialiasing
  1578.  
  1579. This menu item will toggle the antialiasing function on or off when
  1580. displaying images.  The default setting is on. NOTE: Horizontal-Only
  1581. antialiasing is available by using the hl/A/A option, but is not available using
  1582. menus from within GDS.
  1583.  
  1584. To change GDS's default antialiasing method, add hl/A/A<n> to hlConfFileGDSUSER.CFG.
  1585.  
  1586. Related Parameters
  1587.     hl/A/A    Change default antialiasing method
  1588.  
  1589.  
  1590. :::hlViewMenuBeep
  1591. Beep for View Complete
  1592.  
  1593. This menu item will toggle the beep on or off when GDS finishes displaying an
  1594. image on the screen.  The default setting is on.
  1595.  
  1596. To change GDS's default beep setting, add hl/!/!<n> to hlConfFileGDSUSER.CFG.
  1597.  
  1598. Related Parameters
  1599.     hl/!/!    Change default beep setting
  1600.  
  1601.  
  1602. :::hlViewMenuComment
  1603. CompuServe GIF89a Comments
  1604.  
  1605. This menu item will toggle automatic display of GIF89a Comments on or off.
  1606. The default state is on (hl/K/K1).
  1607.  
  1608. To change GDS's default "comment show" state, add hl/K/K<n> to hlConfFileGDSUSER.CFG.
  1609.  
  1610. Related Parameters
  1611.     hl/K/K    Change default "comment show" state
  1612.  
  1613.  
  1614. :::hlViewMenuCatalogStyle
  1615. Catalog Background/Style
  1616.  
  1617. These menu items will set the style of GDS catalogs.  Black and gray catalogs
  1618. tend to look better on video monitors, while white catalogs are preferable for
  1619. printed output because they use less toner (or ink).  The default style is
  1620. white backgrounds (hl/~A/~A1).
  1621.  
  1622. To change GDS's default catalog style, hl/~A/~A<n> to
  1623. hlConfFileGDSUSER.CFG.
  1624.  
  1625. Related Parameters
  1626.     hl/~A/~A    Change catalog style
  1627.     hl/U/U    Turn catalog image borders on and off
  1628.     hl/L/L    Turn catalog image labels on and off
  1629.  
  1630.  
  1631. :::hlViewMenuCenterSlideshow
  1632. Center Slideshow Images
  1633.  
  1634. This menu item will toggle centering of slideshow images on or off. When on,
  1635. GDS will center each slideshow image on the screen. When off GDS will place
  1636. upper left corner of the image in the upper left corner of the screen.
  1637.  
  1638. To change GDS's default slideshow centering mode, add hl/~B/~B<n> to
  1639. hlConfFileGDSUSER.CFG.
  1640.  
  1641. Related Parameters
  1642.     hl/~B/~B    Turn slideshow centering on and off
  1643.  
  1644.  
  1645. :::hlDisplayMenu
  1646. Display Menu
  1647.  
  1648. The following options are available in the File List Display Menu:
  1649. 
  1650.     hlDisplayMenuShowShow Extensions
  1651.     hlDisplayMenuShowShow Resolution
  1652.     hlDisplayMenuShowShow Pixel Bit Depth
  1653.     hlDisplayMenuShowShow File Size
  1654.     --------------------
  1655.     hlDisplayMenuSortSort: Name, Extn
  1656.     hlDisplayMenuSortSort: Size, Resl
  1657.     hlDisplayMenuSortSort: Bits, Resl
  1658.     hlDisplayMenuSortSort: Resl, Name
  1659.     hlDisplayMenuSortSort: Extn, Name
  1660.  
  1661. This menu allows you to change the appearance of the File List by toggling
  1662. file information on or off and sorting files in a variety of orders.
  1663.  
  1664.  
  1665. :::hlDisplayMenuShow
  1666. Display Menu: Show Options
  1667.  
  1668. These menu items control which information GDS displays for each file in the
  1669. File List. The information is displayed in the following order:
  1670. 
  1671.         PICTURE .GIF  640x480x256 250k
  1672. 
  1673.          (1)     (2)  (3) (4) (5) (6)
  1674. 
  1675. 
  1676.         (1) Filename
  1677.         (2) Three-character extension denoting file format
  1678.         (3) Width of file (in hlGlossarypixels)
  1679.         (4) Height of file (in pixels)
  1680.         (5) Number of colors in file (32k = 32,768)
  1681.                          (65k = 65,536)
  1682.                          (16M = 16.7 million)
  1683.         (6) File size
  1684. 
  1685. The default setting shows the extension and the file size. To change the
  1686. GDS's defaults, add hl/F/F... to hlConfFileGDSUSER.CFG.
  1687.  
  1688. Related Parameters
  1689.     hl/F/F    Default file display options
  1690.  
  1691.  
  1692. :::hlDisplayMenuSort
  1693. Display Menu: Sort Order Options
  1694.  
  1695. The display menu has five "Sort" options, each of which controls how files
  1696. are sorted in the GDS file list.  By default, GDS sorts filenames first by
  1697. the name of the file, and then the file extension.  You can change this sort
  1698. order at any time by selecting one of the "Sort: ..." options in the
  1699. "Display" menu (or by using the hl/~O/~O command line parameter.)
  1700.  
  1701.    Sort: Name, Extn
  1702.     Sort by the name of the file, and then the extension.  This is the
  1703.     default sort order of GDS.
  1704.  
  1705.  * Sort: Size, Resl
  1706.     Sort by the size of the file, and then the resolution of the file if
  1707.     two or more files have the same size.
  1708.  
  1709.  * Sort: Bits, Resl
  1710.     Sort by the number of bits per pixel, and then by the resolution of
  1711.     each file, followed by the file name and extension.
  1712.  
  1713.  * Sort: Resl, Name
  1714.     Sort by the resolution of each file (horizontal dimension first,
  1715.     followed by vertical), then by the name and extension of each file.
  1716.  
  1717.    Sort: Extn, Name
  1718.     Sort by the extension of the name first, then the name and size of
  1719.     each file.  This option is very useful when doing a lot of file
  1720.     conversions.
  1721. 
  1722.       * These options require GDS to have read the file headers from every
  1723.     file in the file list before the list can be properly sorted.
  1724.     Choosing any of these sort orders may cause a significant delay
  1725.     while GDS is reading through all of the graphics files.
  1726.  
  1727.  
  1728. :::hlConvMenu
  1729. Convert Menu
  1730.  
  1731. File conversions in GDS are most simply done using the Convert Menu.  This
  1732. menu allows you to select an output file format for one or more hlHowToSelectselected
  1733. files.
  1734.  
  1735. The following options are available in the Convert Menu:
  1736. 
  1737.     hlConvBMP1BMP monochrome        hlConvPCX1PCX monochrome        hlConvTIF1TIF monochrome
  1738.     hlConvBMP4BMP 16  colors        hlConvPCX4PCX 16  colors        hlConvTIF4TIF 16  colors
  1739.     hlConvBMP8BMP 256 colors        hlConvPCX8PCX 256 colors        hlConvTIF8TIF 256 colors
  1740.     hlConvBMP24BMP 16M colors        hlConvRIX4RIX 16  colors        hlConvTIF24TIF 16M colors
  1741.     hlConvGIF1GIF monochrome        hlConvRIX8RIX 256 colors        hlConvCut1Halo CUT/PAL Mono.
  1742.     hlConvGIF4GIF 16  colors        hlConvTGA15TGA 32K colors        hlConvCut4Halo CUT/PAL 16
  1743.     hlConvGIF8GIF 256 colors        hlConvTGA24TGA 16M colors        hlConvCut8Halo CUT/PAL 256
  1744.     hlConvLBM1LBM monochrome        hlConvWPG1WPG monochrome        hlConvJPG24JPG 16M colors
  1745.     hlConvLBM4LBM 16  colors        hlConvWPG4WPG 16  colors
  1746.     hlConvLBM8LBM 256 colors        hlConvWPG8WPG 256 colors        hlConvANSIANSI 80x25 txt
  1747.  
  1748. If there is no currently selected file in the file list, GDS assumes that the
  1749. single file that the file cursor is highlighting is to be converted.  If there
  1750. are any files hlHowToSelectselected in the file list, GDS assumes that all hlHowToSelectselected files
  1751. should be converted as a batch.  (Note that only registered versions of GDS
  1752. support batch conversions.)
  1753.  
  1754. When files are converted, GDS tries to name the files with the same file name,
  1755. but with the new extension.  If the extension is the same as the original
  1756. file, or if a file with the same name exists, GDS will follow the same naming
  1757. procedure as for catalog files.  By default this will cause GDS to write files
  1758. called GDS000, GDS001, GDS002, and so on.
  1759.  
  1760. Also note that unregistered versions of GDS do not support conversions which
  1761. would result in a 24 bit to 8 bit color reduction, and do not support
  1762. conversion to JPEG formats.  Conversions to ANSI format supported in the Sysop
  1763. version of GDS (GDS Professional) only.  hlPhotodexCall us for more information.
  1764.  
  1765. Related Parameters
  1766.     hl/@C/@C    Convert files from the command line
  1767.  
  1768.  
  1769. :::hlConvBMP1
  1770. Converting to Monochrome BMP
  1771.  
  1772. This process generates hlGlossaryFloyd/Steinberg dithered monochrome files with black
  1773. and white as the two colors.  GDS does not support conversion to monochrome
  1774. formats with other than black and white as the output colors.
  1775.  
  1776. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1777. then analyzes and dithers down to monochrome data.  BMP output data is not
  1778. compressed, and is written from bottom to top (standard BMP.)
  1779.  
  1780.  
  1781. :::hlConvBMP4
  1782. Converting to 16 Color BMP
  1783.  
  1784. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1785. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1786. 16 color palette for the image.  If a fixed palette is used, then GDS uses a
  1787. standard Windows 16 color palette and dithers the source image.
  1788.  
  1789. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1790. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1791. direct conversion without modifying the color content at all.  BMP output data
  1792. is not compressed, and is written from bottom to top (standard BMP.)
  1793.  
  1794.  
  1795. :::hlConvBMP8
  1796. Converting to 256 Color BMP
  1797.  
  1798. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1799. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1800. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1801. In this case, the image is converted directly with no modification of color
  1802. content.
  1803.  
  1804. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1805. then analyzes and dithers down to 256 color data, unless it is possible to do
  1806. a direct conversion without modifying the color content at all.  BMP output
  1807. data is not compressed, and is written from bottom to top (standard BMP.)
  1808.  
  1809.  
  1810. :::hlConvBMP24
  1811. Converting to 24 Bit Color BMP
  1812.  
  1813. This process generates a 24 bit image from any image.  Since 24 bit data has
  1814. a fixed palette, the Fixed/Optimal flag in the conversion window is ignored.
  1815.  
  1816. GDS normally reads input files into a 24 bit virtual buffer and then writes
  1817. it out without modifying the color content at all.  BMP output data is not
  1818. compressed, and is written from bottom to top (standard BMP.)  Note that 24
  1819. bit BMP files are very large because they are stored as raw 24 bit data.
  1820.  
  1821.  
  1822. :::hlConvGIF1
  1823. Converting to Monochrome GIF
  1824.  
  1825. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  1826. and white as the two colors.  GDS does not support conversion to monochrome
  1827. formats with other than black and white as the output colors.
  1828.  
  1829. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1830. then analyzes and dithers down to monochrome data.  GIF output data is
  1831. compressed and more efficient than most other monochrome image file formats.
  1832.  
  1833. GDS does not write comment records to GIF files.
  1834.  
  1835.  
  1836. :::hlConvGIF4
  1837. Converting to 16 Color GIF
  1838.  
  1839. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1840. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1841. 16 color palette for the image.  If a fixed palette is used, then GDS
  1842. uses a standard EGA/VGA 16 color palette and dithers the source image.
  1843. Photodex has found that it is often better to convert to a standard EGA fixed
  1844. palette than to try to use an optimized palette, because 16 colors is
  1845. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  1846. well suited for conversion purposes.
  1847.  
  1848. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1849. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1850. direct conversion without modifying the color content at all.  GIF output data
  1851. is compressed and more efficient than most 16 color image file formats.
  1852.  
  1853. GDS does not write comment records to GIF files.
  1854.  
  1855.  
  1856. :::hlConvGIF8
  1857. Converting to 256 Color GIF
  1858.  
  1859. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1860. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1861. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1862. In this case, the image is converted directly with no modification of color
  1863. content.
  1864.  
  1865. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1866. then analyzes and dithers down to 256 color data, unless it is possible to do
  1867. a direct conversion without modifying the color content at all.  GIF output
  1868. data is compressed and more efficient than most 256 color image file formats.
  1869.  
  1870. GDS does not write comment records to GIF files.
  1871.  
  1872.  
  1873. :::hlConvLBM1
  1874. Converting to Monochrome LBM/IFF
  1875.  
  1876. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  1877. and white as the two colors.  GDS does not support conversion to monochrome
  1878. formats with other than black and white as the output colors.
  1879.  
  1880. GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
  1881. far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
  1882. an LBM file written with GDS, you will notice this preview in the "Open"
  1883. dialog.
  1884.  
  1885. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1886. then analyzes and dithers down to monochrome data.  IFF output data is
  1887. compressed and more efficient than raw monochrome image file formats, but the
  1888. compression is not as good as GIF or other LZ compression formats.
  1889.  
  1890. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  1891. IFF files, and there are even books available incorrectly describing how IFF
  1892. works.  Be careful to follow Electronic Arts' IFF specifications precisely.
  1893.  
  1894.  
  1895. :::hlConvLBM4
  1896. Converting to 16 Color LBM/IFF
  1897.  
  1898. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1899. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1900. 16 color palette for the image.  If a fixed palette is used, then GDS
  1901. uses a standard EGA/VGA 16 color palette and dithers the source image.
  1902. Photodex has found that it is often better to convert to a standard EGA fixed
  1903. palette than to try to use an optimized palette, because 16 colors is
  1904. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  1905. well suited for conversion purposes.
  1906.  
  1907. GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
  1908. far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
  1909. an LBM file written with GDS, you will notice this preview in the "Open"
  1910. dialog.
  1911.  
  1912. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1913. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1914. direct conversion without modifying the color content at all.  IFF output data
  1915. is compressed and more efficient than raw 16 color image file formats, but the
  1916. compression is not as good as GIF or other LZ compression formats.
  1917.  
  1918. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  1919. IFF files, and there are even books available incorrectly describing how IFF
  1920. works.  Be careful to follow Electronic Arts' IFF specifications precisely.
  1921.  
  1922.  
  1923. :::hlConvLBM8
  1924. Converting to 256 Color LBM
  1925.  
  1926. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1927. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1928. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1929. In this case, the image is converted directly with no modification of color
  1930. content.
  1931.  
  1932. GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
  1933. far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
  1934. an LBM file written with GDS, you will notice this preview in the "Open"
  1935. dialog.
  1936.  
  1937. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1938. then analyzes and dithers down to 256 color data, unless it is possible to do
  1939. a direct conversion without modifying the color content at all.  IFF output
  1940. data is compressed and is supposed to be more efficient than raw 256 color
  1941. image file formats, but falls short because the IFF compression was designed
  1942. for monochrome and 16 color data.  256 color IFF files can sometimes be even
  1943. larger than the raw 256 color data.
  1944.  
  1945. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  1946. IFF files, and there are even books available incorrectly describing how IFF
  1947. works.  Be careful to follow Electronic Arts' IFF specifications precisely.
  1948.  
  1949.  
  1950. :::hlConvPCX1
  1951. Converting to Monochrome PCX
  1952.  
  1953. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  1954. and white as the two colors.  GDS does not support conversion to monochrome
  1955. formats with other than black and white as the output colors.
  1956.  
  1957. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1958. then analyzes and dithers down to monochrome data.  PCX output data is
  1959. compressed and sometimes more efficient than raw monochrome image file
  1960. formats, but the compression is not as good as GIF or other LZ compression
  1961. formats.
  1962.  
  1963.  
  1964. :::hlConvPCX4
  1965. Converting to 16 Color PCX
  1966.  
  1967. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1968. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1969. 16 color palette for the image.  If a fixed palette is used, then GDS
  1970. uses a standard EGA/VGA 16 color palette and dithers the source image.
  1971. Photodex has found that it is often better to convert to a standard EGA fixed
  1972. palette than to try to use an optimized palette, because 16 colors is
  1973. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  1974. well suited for conversion purposes.
  1975.  
  1976. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1977. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1978. direct conversion without modifying the color content at all.  PCX output data
  1979. is compressed and sometimes more efficient than raw 16 color image file
  1980. formats, but the compression is not as good as GIF or other LZ compression
  1981. formats.
  1982.  
  1983.  
  1984. :::hlConvPCX8
  1985. Converting to 256 Color PCX
  1986.  
  1987. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1988. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1989. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1990. In this case, the image is converted directly with no modification of color
  1991. content.
  1992.  
  1993. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1994. then analyzes and dithers down to 256 color data, unless it is possible to do
  1995. a direct conversion without modifying the color content at all.  256 color
  1996. PCX output data uses an RLE compression method which usually falls apart with
  1997. 256 color files because of dithering.  The only time that 256 color PCX data
  1998. will be smaller than raw image file data is when there are runs of solid
  1999. colors in the 256 color image.
  2000.  
  2001.  
  2002. :::hlConvCUT1
  2003. Converting to Monochrome Halo CUT/PAL
  2004.  
  2005. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  2006. and white as the two colors.  GDS does not support conversion to monochrome
  2007. formats with other than black and white as the output colors.
  2008.  
  2009. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2010. then analyzes and dithers down to monochrome data.  Halo CUT output data is
  2011. only marginally compressed and often less efficient than other common file
  2012. formats.
  2013.  
  2014.  
  2015. :::hlConvCUT4
  2016. Converting to 16 Color Halo CUT/PAL
  2017.  
  2018. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2019. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2020. 16 color palette for the image.  If a fixed palette is used, then GDS
  2021. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2022. Photodex has found that it is often better to convert to a standard EGA fixed
  2023. palette than to try to use an optimized palette, because 16 colors is
  2024. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2025. well suited for conversion purposes.
  2026.  
  2027. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2028. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2029. direct conversion without modifying the color content at all.  Haloc CUT
  2030. files are only marginally compressed and often less efficient than other
  2031. common file formats.
  2032.  
  2033.  
  2034. :::hlConvCUT8
  2035. Converting to 256 Color Halo CUT/PAL
  2036.  
  2037. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2038. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2039. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2040. In this case, the image is converted directly with no modification of color
  2041. content.
  2042.  
  2043. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2044. then analyzes and dithers down to 256 color data, unless it is possible to do
  2045. a direct conversion without modifying the color content at all.  256 color
  2046. CUT output data uses an RLE compression method which usually falls apart with
  2047. 256 color files because of dithering.  The only time that 256 color CUT data
  2048. will be smaller than raw image file data is when there are runs of solid
  2049. colors in the 256 color image.
  2050.  
  2051.  
  2052. :::hlConvWPG1
  2053. Converting to Monochrome WPG
  2054.  
  2055. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  2056. and white as the two colors.  GDS does not support conversion to monochrome
  2057. formats with other than black and white as the output colors.
  2058.  
  2059. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2060. then analyzes and dithers down to monochrome data.  WPG output data is
  2061. compressed and sometimes more efficient than raw monochrome image file
  2062. formats, but the compression is not as good as GIF or other LZ compression
  2063. formats.
  2064.  
  2065.  
  2066. :::hlConvWPG4
  2067. Converting to 16 Color WPG
  2068.  
  2069. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2070. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2071. 16 color palette for the image.  If a fixed palette is used, then GDS
  2072. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2073. Photodex has found that it is often better to convert to a standard EGA fixed
  2074. palette than to try to use an optimized palette, because 16 colors is
  2075. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2076. well suited for conversion purposes.
  2077.  
  2078. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2079. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2080. direct conversion without modifying the color content at all.  WPG output data
  2081. is compressed and sometimes more efficient than raw 16 color image file
  2082. formats, but the compression is not as good as GIF or other LZ compression
  2083. formats.
  2084.  
  2085.  
  2086. :::hlConvWPG8
  2087. Converting to 256 Color WPG
  2088.  
  2089. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2090. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2091. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2092. In this case, the image is converted directly with no modification of color
  2093. content.
  2094.  
  2095. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2096. then analyzes and dithers down to 256 color data, unless it is possible to do
  2097. a direct conversion without modifying the color content at all.  256 color
  2098. PCX output data uses an RLE compression method which usually falls apart with
  2099. 256 color files because of dithering.
  2100.  
  2101.  
  2102. :::hlConvRIX4
  2103. Converting to 16 Color ColorRIX
  2104.  
  2105. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2106. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2107. 16 color palette for the image.  If a fixed palette is used, then GDS
  2108. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2109. Photodex has found that it is often better to convert to a standard EGA fixed
  2110. palette than to try to use an optimized palette, because 16 colors is
  2111. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2112. well suited for conversion purposes.
  2113.  
  2114. ColorRIX files use no compression.
  2115.  
  2116. ColorRIX files use the file extension to denote the resolution of the file.
  2117. This is a huge problem if the image size is not a standard EGA or VGA file
  2118. size.  Because of this problem, the ColorRIX file format is rarely used.
  2119.  
  2120. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2121. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2122. direct conversion without modifying the color content at all.
  2123.  
  2124. :::hlConvRIX8
  2125. Converting to 256 Color ColorRIX
  2126.  
  2127. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2128. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2129. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2130. In this case, the image is converted directly with no modification of color
  2131. content.
  2132.  
  2133. ColorRIX files use no compression.
  2134.  
  2135. ColorRIX files use the file extension to denote the resolution of the file.
  2136. This is a huge problem if the image size is not a standard EGA or VGA file
  2137. size.  Because of this problem, the ColorRIX file format is rarely used.
  2138.  
  2139. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2140. then analyzes and dithers down to 256 color data, unless it is possible to do
  2141. a direct conversion without modifying the color content at all.
  2142. :::hlConvTGA15
  2143. Converting to 32K Color Targa
  2144.  
  2145. This process generates 32,768 color (15 bit) TGA files.  If the source input
  2146. image file is more than 15 bits (16 or 24 bit), then the image is hlGlossaryFloyd-
  2147. hlGlossarySteinberg dithered down to 15 bits, in order to simulate the 24 bit
  2148. data as accurately as possible.  The result is better 15 bit images than most
  2149. common software generates.
  2150.  
  2151. GDS normally reads input files into a 24 bit virtual buffer, which it then
  2152. converts into 15 bit data, unless it is possible to do a direct conversion
  2153. without modifying the color content at all.  TGA files are stored from bottom
  2154. to top.
  2155.  
  2156.  
  2157. :::hlConvTGA24
  2158. Converting to 24 Bit Color Targa
  2159.  
  2160. This process generates 16.7 color (24 bit) TGA files.  If the input data has
  2161. less than 24 bits of color information, the color information is padded out
  2162. to 24 bits.
  2163.  
  2164. GDS normally reads input files into a 24 bit virtual buffer and writes it
  2165. directly out in uncompressed form.  TGA files are stored from bottom to top.
  2166.  
  2167.  
  2168. :::hlConvTIF1
  2169. Converting to Monochrome TIFF
  2170.  
  2171. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  2172. and white as the two colors.  GDS does not support conversion to monochrome
  2173. formats with other than black and white as the output colors.
  2174.  
  2175. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2176. then analyzes and dithers down to monochrome data.  TIF output data is
  2177. not compressed, but is compatible with most imaging software.  Compressed
  2178. formats (such as hlGIF1GIF are more space efficient).
  2179.  
  2180.  
  2181. :::hlConvTIF4
  2182. Converting to 16 Color TIF
  2183.  
  2184. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2185. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2186. 16 color palette for the image.  If a fixed palette is used, then GDS
  2187. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2188. Photodex has found that it is often better to convert to a standard EGA fixed
  2189. palette than to try to use an optimized palette, because 16 colors is
  2190. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2191. well suited for conversion purposes.
  2192.  
  2193. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2194. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2195. direct conversion without modifying the color content at all.  TIF output data
  2196. is not compressed, but is compatible with most imaging software.  Compressed
  2197. formats (such as hlGIF4GIF are more space efficient).
  2198.  
  2199.  
  2200. :::hlConvTIF8
  2201. Converting to 256 Color TIF
  2202.  
  2203. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2204. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2205. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2206. In this case, the image is converted directly with no modification of color
  2207. content.
  2208.  
  2209. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2210. then analyzes and dithers down to 256 color data, unless it is possible to do
  2211. a direct conversion without modifying the color content at all.  TIF output
  2212. data is not compressed, but is compatible with most imaging software.
  2213. Compressed formats (such as hlGIF8GIF are more space efficient).
  2214.  
  2215.  
  2216. :::hlConvTIF24
  2217. Converting to 24 Bit TIFF
  2218.  
  2219. This process generates 16.7 color (24 bit) TIFF files.  If the input data has
  2220. less than 24 bits of color information, the color information is padded out
  2221. to 24 bits.  TIFF compression is not used in the output data stream.
  2222.  
  2223. GDS normally reads input files into a 24 bit virtual buffer and writes it
  2224. directly out in uncompressed form.
  2225.  
  2226.  
  2227. :::hlConvJPG24
  2228. Converting to 24 Bit JPEG/JFIF
  2229.  
  2230. *Note:    The trial version of GDS does not support conversion to JPEG format.
  2231.  
  2232. This process reads input data into a 24 bit virtual screen file and converts
  2233. it into a JPEG format output file confirming to the JFIF file format
  2234. specification.  Because JPEG is a lossy compression mechanism, the output
  2235. file will rarely be exactly the same as the input file, but the differences
  2236. are usually so small that they are very difficult to see.  You can adjust
  2237. the quality level (compression level) by using the hl/~M/~M<n> command line
  2238. parameter.hl/~M
  2239.  
  2240. JPEG compression is best suited for continuous tone (photographic) images,
  2241. and does not do a good job with computer generated images with sharp or high
  2242. contrast (artificial looking) edges.
  2243.  
  2244. JPEG is probably the best thing to happen with 16.7 million color images,
  2245. and should be looked at seriously by professionals in the computer industry
  2246. for most 24 bit imaging applications.
  2247.  
  2248. Special thanks go to the Independent JPEG group for their support of the
  2249. JPEG format through the widespread distribution of their sample source code
  2250. libraries.
  2251.  
  2252.  
  2253. :::hlConvANSI
  2254. Converting to ANSI 16 Color Text
  2255.  
  2256. *Note:    The trial version of GDS does not support conversion to ANSI format.
  2257.     Writing ANSI text files is supported by GDS Professional.  Contact
  2258.     hlPhotodexPhotodex for specific information about GDS Pro.
  2259.  
  2260. This process reads the input image into a virtual buffer and then analyzes it
  2261. to find the best way to represent the image using 79 characters wide and as
  2262. many characters tall as necessary to represent the image.  This process is
  2263. complex and generates a better ANSI image than any other software we have yet
  2264. seen or heard of.
  2265.  
  2266. It is impossible to represent a photographic image very well using ANSI
  2267. because of the huge limitations on color and character cell size.  However,
  2268. GDS has become an important tool to create color ANSI files for BBS system
  2269. operators because it is one of the only programs which offers ANSI export
  2270. capability.
  2271. :::hlScanMenu
  2272. Scan Menu
  2273.  
  2274. The Scan Menu is only available in the Professional version of GDS (GDS
  2275. Pro.)  GDS Pro. supports the following scanners:
  2276. 
  2277.     Epson ES-300C Color Scanner
  2278.     Epson ES-600C Color Scanner
  2279.     Microtek MSF-300G
  2280.     Microtek MSF-300Z
  2281.     Microtek MSF-600G
  2282.     Microtek MSF-600Z
  2283.     Microtek Scanmaker 1850
  2284.     Jovian VIA 320x200 Video Capture Board
  2285.     Jovian SVIA 640x480 Video Capture Board
  2286.  
  2287. If you have one of these devices and are interested in GDS Pro please contact
  2288. Photodex directly at (510) 449-9079 for more information.
  2289.  
  2290.  
  2291. :::hlSetupMenu
  2292. Setup Menu
  2293.  
  2294. The Setup Menu allows you to make minor modifications in your video setup,
  2295. allows you to get the status of GDS, allows you to setup your printer, and
  2296. allows you to alter the default text color scheme.
  2297. 
  2298.     hlSetupMenuConfConfigure Video Modes
  2299.     ------------------------
  2300.     hlSetupMenuSystemSystem Info    [Ctrl-S]
  2301.     ------------------------
  2302.     hlSetupMenuPrintColorPrint In Color
  2303.     hlSetupMenuPrintPortPrinter On PRN
  2304.     hlSetupMenuPrintPortPrinter On LPT1
  2305.     hlSetupMenuPrintPortPrinter On LPT2
  2306.     hlSetupMenuPrintPortPrinter On LPT3
  2307.     ------------------------
  2308.     hlSetupMenuTextText Colors    [Ctrl-P]
  2309.  
  2310. Note:  Printing graphics is supported in enhanced versions of GDS only.
  2311.  
  2312. :::hlSetupMenuConf
  2313. Setup Menu: Reconfiguring Video Modes
  2314.  
  2315. Selecting this menu item will run the automatic configuration for video modes
  2316. that have previously been configured. It allows the removal of modes on the
  2317. system, changing the skew, and flipping RGB order for 24 bit color modes.  It
  2318. will not allow the addition of new video modes, but will allow the omission
  2319. of modes which are not working correctly.
  2320.  
  2321. If a system is improperly configured with less modes than available the only
  2322. way to regain them is to delete the file called CONFIG (with no extension)
  2323. and restart GDS with the proper parameters. This will recreate the CONFIG
  2324. file from scratch.
  2325. :::hlSetupMenuSystem
  2326. Setup Menu: System Information
  2327.  
  2328. Selecting this menu item or pressing [Ctrl-S] will open a window showing
  2329. detailed information about GDS, the hardware, and the current state of the
  2330. system.  If you talk to a Photodex support person, they may ask you to do
  2331. this in order to diagnose any problems.
  2332.  
  2333. Near the top of the display is a block of information containing the version
  2334. number of this copy of GDS, the name and telephone number (registration
  2335. number) of the registered user and the date of registration.
  2336.  
  2337. Below that is a listing of the total and available space on the current
  2338. drive.  GDS will always list the space available on the drive where GDS is
  2339. currently logged. Selecting a valid drive (even if no graphics files are
  2340. available) will display the space on the drive.
  2341.  
  2342. Below the Drive Space is a block showing a number of paths used by GDS.
  2343.  
  2344. Below the path lists is a block showing the current amount of memory GDS has
  2345. to work with. Some GDS functions will reduce the amount of memory available.
  2346. If the amount of DOS System RAM and High DOS RAM start getting low it may be
  2347. a good idea to exit the program and restart it to free up memory.
  2348.  
  2349. Near the bottom of the window GDS lists the current Printer Port, the default
  2350. slideshow image display time and a code for the type of video hardware
  2351. detected by GDS.
  2352.  
  2353.  
  2354. :::hlSetupMenuPrintColor
  2355. Print in Color
  2356.  
  2357. This menu item controls whether or not GDS will attempt to print in color.
  2358. GDS supports color printing on the HP 500C, 550C, 560C, and 1200C. The
  2359. default setting is off.
  2360.  
  2361. To change GDS's default color printing setup, add hl/~J/~J<n> to hlConfFileGDSUSER.CFG.
  2362.  
  2363. Related Parameters
  2364.     hl/~J/~J    Set color or grayscale printing
  2365.     hl/#/#    Configure printer's port
  2366.  
  2367.  
  2368. :::hlSetupMenuPrintPort
  2369. Print to Port
  2370.  
  2371. This set of menu items controls which port GDS sends printing information to.
  2372. Select the port specific to your system. If GDS gives an error message when
  2373. printing is attempted the wrong port may be specified. The default printer
  2374. port is PRN.
  2375.  
  2376. To change the default printer port, add the hl/#/# parameter to hlConfFileGDSUSER.CFG.
  2377.  
  2378. Related Parameters
  2379.     hl/~J/~J    Set color or grayscale printing
  2380.     hl/#/#    Configure printer's port
  2381.  
  2382.  
  2383. :::hlSetupMenuText
  2384. Text Colors
  2385.  
  2386. Selecting this item from the Setup Menu or hitting [Ctrl-P] opens a window
  2387. that allows modification of the colors used on text screens (mainly the File
  2388. List.)  A number of presets are available or the colors can be individually
  2389. modified.  Use the left and right arrow keys to select a color and the
  2390. [F1]-[F6] keys to adjust the RGB value for that color. You can save your
  2391. custom palette as the default by hitting S.
  2392.  
  2393.  
  2394. :::hlHelpMenu
  2395. Help Menu
  2396.  
  2397. The help menu gives you the ability to find out more about GDS.  GDS does so
  2398. much that the help system has become an invaluable part of GDS.
  2399.  
  2400.  
  2401. :::hlResMenu
  2402. Resolution Menu
  2403.  
  2404. This menu will display a complete list of text and graphics modes available
  2405. to GDS. The default resolution is listed on the bottom menu bar. Select the
  2406. desired resolution and it will replace the default in the bottom menu bar.
  2407.  
  2408. The default resolution is the resolution in which GDS catalogs are created.
  2409.  
  2410. *Note:  You can force GDS to use a specific video mode by setting the
  2411.     Auto/Lock Toggle Button into the "Lock" state.  When in this state,
  2412.     GDS will ONLY use the mode listed in the Resolution Menu.
  2413.  
  2414. Text modes can also be changed from the Resolution Menu, but cannot be locked
  2415. using the Auto/Lock Toggle Button.  The available text modes are listed after
  2416. all available graphics modes in the Resolution Menu.
  2417.  
  2418. To change GDS's startup default graphics mode, you can add the hl/G/G option
  2419. to hlConfFileGDSUSER.CFG.
  2420.  
  2421. Related Parameters
  2422.     hl/G/G    Set default graphics mode
  2423.     hl/R/R    Set default Auto/Lock state
  2424.  
  2425.  
  2426. :::hlAutoLockMenu
  2427. Auto/Lock Toggle Button
  2428.  
  2429. This toggle button displays Auto or Lock. In auto mode GDS will attempt
  2430. to choose a display mode that best represents the specific image to be
  2431. displayed. In some cases it is desirable to display only in a specific mode.
  2432. Toggling the Auto/Lock button will force GDS to use the graphics mode
  2433. currently selected from the Resolution Menu. The default setting of the
  2434. Auto/Lock button is Auto.
  2435.  
  2436. To change the default setting of the Auto/Lock toggle button, add hl/R/R<n>
  2437. to hlConfFileGDSUSER.CFG.
  2438.  
  2439. Related Parameters
  2440.     hl/G/G    Set default graphics mode
  2441.     hl/R/R    Set default Auto/Lock state
  2442.  
  2443.  
  2444. :::hlMouseMenu
  2445. Mouse Cursor Style
  2446.  
  2447. Toggling the Mouse Bits/Boxy toggle changes the style of the mouse cursor from
  2448. a bitmapped arrow shape (Bits) to a square (Boxy) style.  Some video cards do
  2449. not support the programmable VGA character set properly, and some distortion
  2450. may appear around the mouse.  You can use this toggle to change the mouse
  2451. cursor into a solid character box.
  2452.  
  2453. Related Parameters
  2454.     hl/B/B    Set default mouse cursor mode
  2455.  
  2456.  
  2457. :::hlPaletteMenu
  2458. Palette Menu
  2459.  
  2460. If you are not familiar with image processing techniques, this menu is
  2461. probably better left alone.  It's functions are very powerful, but can lead
  2462. to a lot of confusion if you have misunderstandings about each function.
  2463.  
  2464. If you are a developer, you may find GDS to be one of the most powerful tools
  2465. you use.
  2466.  
  2467. The Palette Menu name always shows the number of colors to be used in optimal
  2468. palettes (usually 256).  You can change this number by hlLimitPallimiting the palette.
  2469.  
  2470. The Palette Menu is divided into three sections.  Each section serves a unique
  2471. purpose.  These sections are as follows:
  2472.  
  2473.     hlLimitPalLimiting Optimal Palette Colors
  2474.     hlFetchPalGenerating/Fetching Palettes from Image Files
  2475.     hlLockPalLocking/Unlocking the Palette
  2476.  
  2477. Most GDS customers use GDS to view collections of image files and will never
  2478. have a need for these palette functions.  If you are a BBS sysop, or a
  2479. software developer of image related software (who isn't these days!) and you
  2480. have a specific need for these functions, GDS can be very useful.
  2481.  
  2482. If you have other needs related to GDS's abilities, please contact Photodex.
  2483. Our optimized palette generation software has been used in many commercial
  2484. applications through special arrangements.
  2485.  
  2486.  
  2487. :::hlLimitPal
  2488. Limiting Optimal Palette Colors
  2489.  
  2490. GDS can display just about any picture on any video display.  It does this
  2491. through internal palette locking and high speed color translation.  For
  2492. example, if GDS needs to display a 256 color image on a 16 color display,
  2493. it generates a 16 color palette, locks the palette internally, creates the
  2494. necessary tables and then converts the 256 colors into the available 16
  2495. colors on the fly.
  2496.  
  2497. Occasionally, it is necessary to leave space in a palette for palette entries
  2498. which will change or need to be set to specific colors.  You can do this by
  2499. choosing the number of colors in the top of the Palette Menu, or by using the
  2500. hl/M/M Command Line Parameter.
  2501.  
  2502. When one of these top menu items is selected, GDS will limit it's optimal
  2503. palette generation to only the number of specified colors, and leave the
  2504. remaining entries black.  All colors are moved to the top of the palette, in
  2505. other words, they are moved toward the last color in the palette.
  2506.  
  2507. There are other undocumented palette functions (like /~S, /~P, /~4) which can
  2508. help your application.  Photodex does not normally document these command
  2509. line parameters because they are extremely complex.  If you want to know
  2510. how they work, you will need to establish a working arrangement with
  2511. Photodex.  Contact Photodex at (510) 449-9079 for more information.
  2512.  
  2513. Related Topics
  2514.     hlFetchPalGenerating/Fetching Image File Palettes
  2515.     hlLockPalLocking/Unlocking the Palette
  2516.  
  2517.  
  2518. :::hlFetchPal
  2519. Generating/Fetching Image File Palettes
  2520.  
  2521. GDS can create an optimal palette from an arbitrary batch of files.  You can
  2522. do this by selecting one or more files and choosing "Lock Selected/Unlock"
  2523. from the Palette Menu.
  2524.  
  2525. Note that the "Lock Selected/Unlock" option has two purposes.  If the palette
  2526. is not locked, then a palette is created using the selected files.  If the
  2527. palette is locked to something (either through optimal palette generation or
  2528. choosing one of the prefabricated palette options), then GDS simply unlocks
  2529. the palette.
  2530.  
  2531. Once the palette is locked, then GDS will display all pictures using that
  2532. locked palette unless a video mode with more than 8 bits per pixel is used.
  2533. GDS normally chooses the best video mode to display pictures in, and may
  2534. choose a 15, 16 or 24 bit video mode, in which case, the locked palette will
  2535. not be used.  You can avoid this by using the hlAutoLockMenuAuto/Lock Resolution Toggle
  2536. hlAutoLockMenuButton.
  2537.  
  2538. All viewing, hlHowToSlideshowslideshowing, hlHowToCatalogcataloging and hlHowToConvertconversion is subjected to locked
  2539. palettes.  You can use this palette before a hlHowToConvertbatch conversion, for example.
  2540.  
  2541. It is a good idea to remember to unlock a palette (using the "Lock
  2542. Selected/Unlock" option) after you're done with your task.  Things can become
  2543. very confusing when using locked palettes, because it may not be apparent
  2544. that the palette is locked when working with GDS on other things.
  2545.  
  2546. The state of the palette is temporary during each session of GDS, so it is
  2547. not necessary to unlock the palette before you exit.  The next time you run
  2548. GDS, the palette will not be locked.
  2549.  
  2550. Related Parameters
  2551.     hl/M/M    Set Optimal Palette Colors
  2552.  
  2553.  
  2554. :::hlLockPal
  2555. Locking/Unlocking the Palette
  2556.  
  2557. Note: For information about locking the internal GDS palette to an image file,
  2558. see hlFetchPalGenerating/Fetching Image File Palettes.
  2559.  
  2560. GDS has several built-in palettes which can be convenient.  These palettes
  2561. are displayed in the lower part of the Palette Menu:
  2562.  
  2563.     Lock to 5 color RGB    (b&w + red, green, blue)
  2564.     Lock to 8 RGB        (b&w + red, green, blue, cyan, magenta, yellow)
  2565.     Lock to 16 EGA
  2566.     Lock to 16 Windows
  2567.     Lock to 16 RGB
  2568.     Lock to 256 RGB
  2569.     Lock to CMYK Print    (approximation of CMYK paper output)
  2570.  
  2571. When you choose one of these palettes, GDS locks the internal palette to the
  2572. colors in the prefabricated palette.  This means that GDS will only use the
  2573. colors in the locked palette to display pictures (unless the video mode used
  2574. is 15, 16 or 24 bit).
  2575.  
  2576. All viewing, hlHowToSlideshowslideshowing, hlHowToCatalogcataloging and hlHowToConvertconversion is subjected to locked
  2577. palettes.  You can use this palette before a hlHowToConvertbatch conversion, for example.
  2578.  
  2579. To unlock the palette, select "Lock Selected/Unlock" option in the Palette
  2580. menu.  Note that this option has two purposes; see hlFetchPalGenerating/Fetching Image
  2581. hlFetchPalFile Palettes for more information.
  2582.  
  2583.  
  2584. :::hlHowToView
  2585. How To View Images
  2586.  
  2587. GDS has one of the fastest viewing interfaces for image files available.
  2588. Simply double click on a filename with a mouse or press [Enter] with the file
  2589. selected, and GDS displays the file.  To exit the view mode, press [Esc] or
  2590. click the mouse button.
  2591.  
  2592. *Note:    GDS has been tuned to be interruptable in most places.  For example,
  2593.     if the [Esc] key is typed even while an image is being displayed, GDS
  2594.     exits very quickly to the File List screen.
  2595.  
  2596. The view mode is very sophisticated, and a full description of the actual
  2597. capabilities GDS offers would seem very intimidating to the average user.  If
  2598. your goal is to be able to view pictures, then you already know enough to
  2599. have great fun with GDS.  If you want to know everything, read on!
  2600.  
  2601. Related Topics
  2602.     hlViewModeMenuView Mode Menus
  2603.     hlViewModeCommandsView Mode Keyboard Commands
  2604.     hlViewTheoryHow GDS Processes Images
  2605.  
  2606.  
  2607. :::hlViewTheory
  2608. How GDS Processes Images
  2609.  
  2610. Many people call us and say "my pictures look better when GDS displays them".
  2611. At first, we assumed that this was just the strange rantings of loyal users.
  2612. However, after we heard it for the 50th time, we checked it out.  The users
  2613. are absolutely right, but the reasons don't really impress us.  It turns out
  2614. that most other software is just doing less of a job of it.  GDS doesn't
  2615. actually make the graphics look better, it just doesn't make it look worse.
  2616.  
  2617. GDS does a lot to make sure that the content of an image file is rendered to
  2618. the screen as precisely as possible (we think this should be standard.)  It's
  2619. not.  Most other software drops bits in 24 bit data to display 15 and 16 bit
  2620. versions, which destroys the images.  Most viewers do not generate optimized
  2621. palettes in order to display 256 color versions of 24 bit files.  The
  2622. technical discussion that could result out of a comparison of GDS to other
  2623. image processing software could go on for days, so we won't bother.
  2624.  
  2625. If you're not technical, the following brainstorm may appear to be a mass of
  2626. random words that only geeks sitting in front of re-runs of Star Trek would
  2627. utter in a heightened argument about Spock's tools.  If you're technical and
  2628. can understand this, then you're a geek, and ...welcome to the club!  I hope
  2629. this section gives you some insight into the very complex world of GDS guts.
  2630.  
  2631. GDS has a monolithic graphics pipeline with many flags and switches which
  2632. affect the way image data is processed.  All of the factors involved in what
  2633. GDS is attempting to do affect exactly how image information is handled.  The
  2634. reason GDS is so fast is because the slow things (most of it) have been hand
  2635. coded in assembly language (three or more generations of optimization).
  2636. Another reason it is so fast is that about 95% of the usually slow processes
  2637. occur almost exclusively in the default data segment.
  2638.  
  2639. When GDS displays an image (via double click or [Enter] key), GDS first makes
  2640. sure that it can recognize the file, and then decides how the data will be
  2641. processed.  If the source file is 24 bits per pixel but the best screen mode
  2642. available only has 8 bits per pixel, then GDS goes through the histogram
  2643. generation, modified heckbert subdivision algorithm and conversion table
  2644. processes necessary to prepare to convert from 24 bits downward.
  2645.  
  2646. Things like 24 bit sharpening are done at the tail end of the process, while
  2647. things like incoming 15, 16 and 24 bit gamma/contrast/brightness adjustment
  2648. are done in the file format drivers, which are built into the code.  GDS is
  2649. not based on drivers.
  2650.  
  2651. Most of the code does not care if the current operation is happening on a
  2652. physically displayed screen, or if it's happening in a virtual file.  This
  2653. is what drives most of the command line functionality.
  2654.  
  2655. Most command line operations automatically create virtual files (perhaps with
  2656. XMS rather than disk files).  XMS is cached into system RAM when needed, and
  2657. should behave at or better than 95% of the speed of screen images.
  2658.  
  2659.  
  2660. :::hlHowToSlideshow
  2661. How To Play a Slideshow
  2662.  
  2663. 1) Use the mouse or keyboard to hlHowToSelectselect the files you want to show.
  2664.    Notice when you hold down the shift key, you can click
  2665.    on files to toggle their selection state, and you can also drag the
  2666.    mouse to select and deselect ranges.  It's easy to select the exact
  2667.    files you want.
  2668.  
  2669. 2) Click on the box in the lower right corner of the GDS
  2670.    file display area labeled "hlMenusClick Here For Slide Show!", or
  2671.    choose hlViewMenuSlideshowSlideshow from the hlViewMenuView Menu.
  2672.  
  2673. 3) You can change the delay in the slideshow by using the
  2674.    hl/Z/Z<n> option at the command line.
  2675.  
  2676. See Also
  2677.     hlHowToCLSlideshowSlideshows from the Command Line
  2678.     hlViewMenuSlideshowView Slideshow (View Menu Option)
  2679.  
  2680. Related Parameters
  2681.     hl/E/E    Fit images
  2682.     hl/O/O    Set sort options
  2683.     hl/Z/Z    Image delay
  2684.  
  2685.  
  2686. :::hlHowToCLSlideshow
  2687. Slideshows from the Command Line
  2688.  
  2689. Type "GDS hl/S/S" followed by filenames or paths and perhaps some of
  2690. the following options:
  2691. 
  2692.     hl/E/E    Fit images
  2693.     hl/O/O    Set sort options
  2694.     hl/X/X    Exit to DOS after last image
  2695.     hl/Z/Z    Image delay
  2696.  
  2697. Note that these command line options each need a number directly after them
  2698. on the command line.  For more information, see the command line reference.
  2699.  
  2700. For example, to do a slideshow of all of the files in the C:\PICS directory
  2701. with two seconds between the display of each image, use the following
  2702. command line:
  2703. 
  2704.     GDS hl/S/S C:\PICS hl/Z/Z20
  2705.  
  2706. GDS can also be used to simply put a picture on the screen as follows:
  2707. 
  2708.     GDS hl/S/S hl/X/X filename.gif
  2709.  
  2710. See Also
  2711.     hlHowToSlideshowHow to Play a Slideshow
  2712.  
  2713. Related Parameters
  2714.     hl/E/E    Fit images
  2715.     hl/O/O    Set sort options
  2716.     hl/X/X    Exit to DOS after last image
  2717.     hl/Z/Z    Image delay
  2718.  
  2719.  
  2720. :::hlHowToCatalog
  2721. How To Create Catalogs
  2722.  
  2723.  1) hlHowToSelectSelect all files by clicking on the first desired file in the file list
  2724.     and dragging the mouse to the end of the file list.  You can also create
  2725.     a catalog of any combination of files.  You can hold down the <Shift> key
  2726.     while using the mouse to add and subtract files from being selected.
  2727.     Also, if no files are selected, GDS will catalog every listed file.
  2728.  
  2729.  2) Next, select hlViewMenuCatalogCreate Catalog from the hlViewMenuView Menu.  Use the "up" and
  2730.     "down" arrow keys to increase or decrease the number of thumbnails
  2731.     displayed on the screen.
  2732.  
  2733.  3) Make sure the "Borders" and "Labels" options are set as you want them.
  2734.     Type "L" and "B" to change them, or use the mouse and click on the
  2735.     "Labels" and "Borders" buttons.
  2736.  
  2737.  4) Press [Enter] to start generating the catalogs.
  2738.  
  2739.  5) When each screen is complete, press <Alt-W> or <Alt-J> to write the screen
  2740.     out as a GDS catalog .GIF or .JPG file.  GDS names the files sequentially
  2741.     like GDS000, GDS001, GDS002, etc.  To change the default naming scheme,
  2742.     you may use the hl/N/N command line option.
  2743.  
  2744.     *SPECIAL NOTE: If you want to write all remaining catalog screens in one
  2745.      batch, you can use <Ctrl-W> or <Ctrl-J> rather than <Alt-W> or <Alt-J>.
  2746.  
  2747.  6) You can print the catalog image by pressing 'P' at the prompt after each
  2748.     catalog screen is completed.  If you do, GDS prints the catalog image and
  2749.     then returns you to the prompt again, in case you want to save the file or
  2750.     exit.  GDS supports Hewlett Packard LaserJet II, 3, 4 and compatible
  2751.     printers (also see the hl/#/# command line option for printer configuration
  2752.     information; the printer must be configured properly using the hlSetupMenuSetup
  2753.     hlSetupMenuMenu).
  2754.  
  2755.     Note:    Printing graphics is supported in enhanced
  2756.         versions of GDS only.
  2757.  
  2758.  7) You're done.  When you look at the GIF or JPG files, you will be able to
  2759.     click on a picture to see the original, as long as the original file is
  2760.     in the current file list.  You can also use <PgUp> and <PgDn> to move
  2761.     through multiple screen catalogs while viewing the catalogs.
  2762.  
  2763.  NOTE:  There is an arbitrary maximum of 100 "point-and-shoot" thumbnails
  2764.     per catalog screen.  In other words, if your catalog has more than
  2765.     100 thumbnails, only the first 100 will allow you to click on an
  2766.     image and refer to the original.
  2767.  
  2768. Some users like to generate catalogs with a black background, rather than a
  2769. white one.  Other users like the look of the 3D (Gray) catalogs.  White
  2770. backgrounds are the default mode for GDS, and are great for printing.  If
  2771. you need to change the style of the catalog, you can change the style using
  2772. the hlViewMenuView Menu, or one of the command line parameters
  2773. listed below.
  2774.  
  2775. See hlCmdCatCatalog Parameters for list of command line parameters related to
  2776. creating GDS catalogs.
  2777.  
  2778. Related Topics
  2779.     hlBBSCataloging a BBS
  2780.  
  2781.  
  2782. :::hlHowToCLCatalog
  2783. Catalogs from the Command Line
  2784.  
  2785. If you are cataloging large numbers of images, you can use the hl/W/W<n> command
  2786. hl/Wline option to tell GDS to automatically write catalog images.  Here's how it
  2787. works:
  2788. 
  2789.   1) Start GDS with the hl/W/W<n> option.  For example, hl/W/W4 would write the
  2790.      first catalog as GDS004.GIF.  It is alright to use hl/W/W0 if necessary.
  2791. 
  2792.   2) Use GDS to create the first catalog screen (as described above).
  2793. 
  2794.   3) When GDS is done creating the catalog, type <Alt-W> to write the image as
  2795.      a GIF file and continue making catalog screens.  From this point on, GDS
  2796.      will automatically write successive catalog screens to GIF files.
  2797.  
  2798. This process can also be automated from the command line, by using the hl/P/P
  2799. option.  Just specify the path/file specification of the files to be cataloged
  2800. and include the hl/P/P<n> and hl/W/W<n> options.  The hl/P/P option sets the number
  2801. of thumbnails across for the catalog screens.  For example, hl/P/P4 creates
  2802. catalog screens with four thumbnails across, and probably four high.  Note
  2803. that in lower resolutions, it is possible to have the number of thumbnails
  2804. across be INEQUAL to the number of thumbnails high (it's rare.)
  2805.  
  2806. See hlCmdCatCatalog Parameters for list of command line parameters related to creating
  2807. GDS catalogs.
  2808.  
  2809. Related Topics
  2810.     hlBBSCataloging a BBS
  2811.  
  2812.  
  2813. :::hlHowToConvert
  2814. Converting Files
  2815.  
  2816. There are three methods for converting files with GDS:
  2817. 
  2818.     hlConvMenuThe Convert Menu
  2819.     hlFileConvertConverting from the main GDS file list using the menus
  2820.     hlViewWriteWriting out a displayed image while viewing an image
  2821.     hl/@CConverting files from the command line
  2822.  
  2823.  
  2824. :::hlFileConvert
  2825. Converting Files in the File List
  2826.  
  2827. To convert files from the main GDS File List using the menus:
  2828. 
  2829.  1) Select a file or a group of files to convert.  You can select multiple
  2830.     files by clicking and holding the mouse button while dragging the pointer
  2831.     over a number of files.  You can also select multiple ranges by holding
  2832.     down [Shift] while clicking on file names to select or deselect them.
  2833.  
  2834.  2) Pull down the "Convert" menu with the mouse (or type [Alt-C]) and then
  2835.     select the desired type of file.
  2836.  
  2837.  3) GDS will open a dialog box that allows you to ROTATE the image or MIRROR
  2838.     (flip) it vertically or horizontally as it writes out the file.  GDS will
  2839.     attempt to name the file the same as the source but with the new
  2840.     extension.  If the extension is the same, or a file with the name already
  2841.     exists, GDS will name the file GDS<n> where <n> is the next available
  2842.     number, i.e. GDS000, GDS001, GDS002...
  2843. 
  2844. *Note:  The trial version does not support "batch conversions."  It will,
  2845.     however, convert non-color reduced files to all formats except
  2846.     24 bit JPEG format.
  2847.  
  2848.  
  2849. :::hlViewWrite
  2850. Writing Images From View Mode
  2851.  
  2852. To convert files from the view screen (writes displayed image to file):
  2853. 
  2854.  1) (OPTIONAL) To save a portion of the displayed image: move the mouse
  2855.     pointer to the "File" menu and highlight "Set Save Rect".  Release the
  2856.     mouse button.  Move the mouse pointer to one corner of the rectangular
  2857.     area you want to save.  Click and hold the mouse button.  Drag the
  2858.     rectangle that appears to the desired size.  Release the mouse button.
  2859.     Only the area inside the rectangle will be saved by following the
  2860.     remaining steps.  (If you are unhappy with your selection you can return
  2861.     the crop rectangle to include the entire screen by selecting "Reset Crop
  2862.     Rectangle" from the "File" menu.)
  2863.  
  2864.  2) Move the mouse pointer to the top of the view screen; click and hold the
  2865.     mouse button down.  The "View Mode Menu Bar" will appear.
  2866.  
  2867.  3) Move the mouse pointer to the "File" menu.
  2868.  
  2869.  4) Highlight the type of destination file by moving the mouse pointer to it,
  2870.     and release the mouse button to select the format.
  2871.  
  2872.  5) GDS will write the graphics file, and, if successful, open a dialog box
  2873.     so you can rename the file if you like.  If the name GDS picks is
  2874.     acceptable, hit [Enter].  Otherwise change the name and hit [Enter].  GDS
  2875.     displays a warning message if you try to use a name that already exists,
  2876.     and will not overwrite an existing file during the rename function.
  2877.  
  2878.  6) If you are writing the same format as the file you are viewing, GDS
  2879.     displays a small prompt that asks you if you want to overwrite the file.
  2880.     If you choose 'Y' for yes, then GDS will overwrite the file if the image
  2881.     and be successfully written.  If you choose 'N', then GDS will write the
  2882.     file to a file such as GDS000, GDS001, etc.  Choosing 'Esc' at this prompt
  2883.     cancels the write function and no file will be written.
  2884.  
  2885.  
  2886. :::hl/!
  2887. /! Parameter (View Beep)
  2888.  
  2889.  /!<n>  - Enable/disable beep after display of image
  2890.     /!0 - Don't beep
  2891.     /!1 - Beep (default)
  2892. :::hl/A
  2893. /A Parameter (Default Antialiasing Mode)
  2894.  
  2895.  /A<n>  - Antialiasing level
  2896.     /A0 - No antialiasing
  2897.     /A1 - Horizontal antialiasing
  2898.     /A2 - Two dimensional (default)
  2899. :::hl/B
  2900. /B Parameter (Default Mouse Cursor State)
  2901.  
  2902.  /B<n>  - Default mouse mode
  2903.     /B0 - Character mouse pointer
  2904.     /B1 - Bitmapped mouse pointer (default)
  2905. :::hl/C
  2906. /C Parameter (Bits in Color DAC)
  2907.  
  2908.  /C<n>  - Set number of bits in DAC chip (or 0 to use BIOS palette calls)
  2909.     /C0 - Use BIOS ONLY for palette (also kills screen saver)
  2910.     /C6 - Standard VGA DAC (default)
  2911.     /C8 - Cool expensive DAC (8 bits per color bar)
  2912. :::hl/D
  2913. /D Parameter (Default Dithering Mode)
  2914.  
  2915.  /D<n>  - Set default dither mode
  2916.     /D0 - No dithering
  2917.     /D1 - 2x2 two color matrix
  2918.     /D2 - 2x2 four color matrix (default)
  2919. :::hl/E
  2920. /E Parameter (Image/Screen Fit Mode)
  2921.  
  2922.  /E<n>  - Set image/screen fit mode (0=norm, 1=fit)
  2923.     /E0 - Do not fit viewed images to the screen (default)
  2924.     /E1 - Fit all images to the screen
  2925. :::hl/F
  2926. /F Parameter (Default File Display Options)
  2927.  
  2928.  /F#### - Set options for file display
  2929.  
  2930.     Each of the four number signs holds the position of each of the
  2931.     following single character parameters below.  Specify a '1' or a '0'
  2932.     to enable or disable the display of each of these types of data:
  2933.  
  2934.     ■ Extension    ■ Resolution    ■ Bits/Pixel    ■ File Size
  2935.  
  2936.     For example:  /F0110 enables the resolution and bits per pixel, but
  2937.     disables the extension and file size.
  2938. :::hl/G
  2939. /G Parameter (Default Graphics Resolution)
  2940.  
  2941.  /G<X>x<Y>x<B>  - Set default graphics mode:
  2942.         <X> - Horizontal Resolution (pixels wide)
  2943.         <Y> - Vertical Resolution (pixels high)
  2944.         <B> - Number of Colors (or bits per pixel):
  2945.         16 - 16 colors
  2946.         256 - 256 colors
  2947.         32k - 32,768 colors
  2948.         64k - 65,536 colors
  2949.         16M - 16.7 million colors (24 bit)
  2950.  
  2951.     Examples:       /g640x480x256    (640x480 256 colors)
  2952.             /g1024x768x16m    (1024x768 16.7 million colors)
  2953. :::hl/H
  2954. /H Parameter (Display Help)
  2955.  
  2956.  /H /?  - Display help screen (or /?)
  2957. :::hl/I
  2958. /I Parameter (Interlaced Fill Mode)
  2959.  
  2960.  /I<n>  - Set interlaced fill mode for GIF images
  2961.     /I0 - Disable early filled interlaced GIFs (default)
  2962.     /I1 - Enable interlaced filling
  2963. :::hl/K
  2964. /K Parameter (File Comment Mode)
  2965.  
  2966.  /K<n>  - Controls automatic GIF comment display after image read
  2967.     /K0 - Disable comments
  2968.     /K1 - Enable comments
  2969. :::hl/L
  2970. /L Parameter (Catalog Label Switch)
  2971.  
  2972.  /L<n>  - Control Catalog Labeling
  2973.     /L0 - Don't display labels under catalog thumbnails
  2974.     /L1 - Display labels under catalog thumbnails
  2975.     /L2 - Display labels only, centered under thumbnails
  2976. :::hl/LAPTOP
  2977. /LAPTOP Parameter (Avoid Older Video Modes)
  2978.  
  2979.  /LAPTOP- Use on some laptops to avoid older modes.
  2980.             NOTE: This option is the same as using: /NOCGA /NOEGA /NOHERC
  2981. :::hl/M
  2982. /M Parameter (Maximum Optimal Palette Colors)
  2983.  
  2984.  /M<n>  - Maximum colors to use during color reduction
  2985.  
  2986.     *Note:    Use values between 16 and 256 for best results.
  2987. :::hl/N
  2988. /N Parameter (Automatic Filename Template)
  2989.  
  2990.  /N<str>- Set "printf" style template for output files (default="GDS%03d")
  2991.  
  2992.     If you are not familiar with printf() style formatting, refer to a
  2993.     reference text on the 'C' libraries.  In general, the '%03d' holds
  2994.     the place of a three digit number.  You can change anything else in
  2995.     the string, but you cannot add an extension.
  2996.  
  2997.     Examples:    /NABCD%03d    (result="ABCD000")
  2998.             /N%08d        (result="00000000")
  2999.             /N%02d_SAUCE    (result="00_SAUCE")
  3000. :::hl/NOCGA
  3001. /NOCGA Parameter (Avoid CGA Modes)
  3002.  
  3003.  /NOCGA - Ignore CGA modes (useful for laptops/notebooks).
  3004. :::hl/NOEGA
  3005. /NOEGA Parameter (Avoid EGA Modes)
  3006.  
  3007.  /NOEGA - Ignore EGA modes (useful for laptops/notebooks).
  3008. :::hl/NOHERC
  3009. /NOHERC Parameter (Avoid Hercules Mono Mode)
  3010.  
  3011.  /NOHERC- Ignore Hercules monochrome mode (useful for laptops/notebooks).
  3012. :::hl/NOMONO
  3013. /NOMONO Parameter (Avoid Mono Modes)
  3014.  
  3015.  /NOMONO- Ignore all monochrome modes (useful for people who like color).
  3016. :::hl/NOVESA
  3017. /NOVESA Parameter (Don't Trust VESA)
  3018.  
  3019.  /NOVESA- Do NOT trust VESA for mode configuration information.
  3020. :::hl/NOIDEA
  3021. /NOIDEA Parameter (Extra Support)
  3022.  
  3023.  /NOIDEA- Use just before calling technical support.
  3024. :::hl/O
  3025. /O Parameter (Slideshow Sort Flag)
  3026.  
  3027.  /O<n>  - Set sort flag for slideshow
  3028.     /O0 - Don't sort before slideshow
  3029.     /O1 - Sort before slideshow (honors hl/~O/~O setting)
  3030.  
  3031. Related Topics
  3032.     hl/~O/~O    File Sort Mode    
  3033. :::hl/OK
  3034. /OK Parameter (Avoid Video BIOS Check)
  3035.  
  3036.  /OK    - Assume CONFIG file is correct and use it.  Note: this switch avoids
  3037.           GDS's automatic re-configuration of video hardware.  If you have a
  3038.           video card which arbitrarily changes it's own video BIOS contents,
  3039.           then put this switch in your hlConfFileGDSUSER.CFG as follows:
  3040.  
  3041.             auto,/ok     ;assume CONFIG is ok to use
  3042. :::hl/P
  3043. /P Parameter (Generate Catalogs)
  3044.  
  3045.  /P<n>  - Automatically generate catalogs and write them.  <n> determines how
  3046.     many thumbnails will appear across the catalog.  For example, if you
  3047.     need four thumbnails across and down, use the following switch:
  3048.  
  3049.     /P4
  3050.  
  3051.     A special mode has been added which triggers the handy command line
  3052.     catalog interface in GDS:
  3053.  
  3054.     /P?
  3055.  
  3056.     This catalog interface can be used in a BBS if the standard input and
  3057.     output streams are directed to the modem.
  3058.  
  3059. Related Topics
  3060.     hlCmdCatCatalog Parameters
  3061. :::hl/Q
  3062. /Q Parameter (Specify Catalog Logo File)
  3063.  
  3064.  /Q<x>_<y>_<name> Add logo to automatic catalogs (use with hl/P/P<n>)
  3065. :::hl/QUIET
  3066. /QUIET Parameter
  3067.  
  3068.  /QUIET - Prevents GDS from displaying opening screen on startup.
  3069.  
  3070.  
  3071. :::hl/R
  3072. /R Parameter (Set Auto/Lock State)
  3073.  
  3074.  /R<n>  - Set default resolution 'Lock' mode (0=AutO, 1=LOck)
  3075. :::hl/S
  3076. /S Parameter (Play Slideshow)
  3077.  
  3078.  /S     - Slideshow mode (no user interface, just automatic slideshow)
  3079. :::hl/T
  3080. /T Parameter (Set Default Text Mode)
  3081.  
  3082.  /T<h>x<v>  - Set default text mode
  3083.         <h> Horizontal resolution
  3084.         <v> Vertical resolution
  3085.  
  3086.         Example:    GDS /T80x25
  3087. :::hl/U
  3088. /U Parameter (Catalog Borders On/Off)
  3089.  
  3090.  /U<n>  - Control Catalog Borders
  3091.     /U0 - No borders around thumbnails
  3092.     /U1 - Put borders around thumbnails
  3093.  
  3094. Related Topics
  3095.     hlCmdCatCatalog Parameters
  3096. :::hl/V
  3097. /V Parameter (Set Vertical Orientation)
  3098.  
  3099.  /V<n>  - Set vertical orientation file display (0=horiz, 1=vert)
  3100. :::hl/W
  3101. /W Parameter (Set Auto Filename Number)
  3102.  
  3103.  /W<n>  - Automatically write catalogs GDS<n++>.GIF after first screen
  3104. :::hl/X
  3105. /X Parameter (Exit to DOS)
  3106.  
  3107.  /X     - Exit to DOS after displaying image, but leave graphics mode up
  3108. :::hl/Z
  3109. /Z Parameter (Set Slideshow Delay)
  3110.  
  3111.  /Z<n>  - Set slideshow delay in 100ths of seconds: Default is 300 (3 seconds)
  3112. :::hl/#
  3113. /# Parameter (Set Printer Port/Filename)
  3114.  
  3115.  /#<lpt#:> - Set filename of printer device (ie:  /#LPT2 ; default is /#PRN)
  3116.           NOTE: The printer must be configured correctly to avoid the annoying
  3117.           error messages.
  3118. :::hl/=
  3119. /= Parameter (Set Video Palette Processes)
  3120.  
  3121.  /=<bn> - Set default red/green/blue/contrast/brightness/color/sharpness
  3122.             /=R<n> - Default red level (+/- 255)
  3123.             /=G<n> - Default green level
  3124.             /=B<n> - Default blue level
  3125.             /=C<n> - Default contrast (+/- 255)
  3126.             /=+<n> - Default brightness (+/- 255)
  3127.             /=L<n> - Default color level (+/- 255)
  3128.             /=S<n> - Default 24 bit sharpening level (0-10+)
  3129.             /=H<n> - Default hue setting (0-255)
  3130. :::hl/~0
  3131. /~0 Parameter (Always Clear Screen Flag)
  3132.  
  3133.  /~A<n> - Set flag for manually clearing the graphics screen
  3134.  
  3135.     <n> must be one of the following values:
  3136.         0 = Assume the video card will properly clear the screen
  3137.         1 = Don't assume ANYTHING, and always clear the screen
  3138.  
  3139.     Examples:    GDS /~01    Always clear the screen
  3140.             GDS /~00    Trust your video card's BIOS to
  3141.                     clear the screen...
  3142. :::hl/~A
  3143. /~A Parameter (Set Catalog Style)
  3144.  
  3145.  /~A<n> - Set the style of GDS catalogs.
  3146.  
  3147.     <n> must be one of the following values:
  3148.         0 = Black background with tan borders
  3149.         1 = White background with black borders (Default)
  3150.         2 = Gray backgrounds with 3-D looking image borders
  3151.  
  3152.     Example:    GDS /~A2    Default to Gray/3D catalogs
  3153. :::hl/~B
  3154. /~B Parameter (Set Slideshow Centering)
  3155.  
  3156.  /~B<n> - Set automatic centering mode of slideshows.
  3157.  
  3158.     /~B0 - Do not center slideshow images
  3159.     /~B1 - Center slideshow images (default)
  3160. :::hl/~E
  3161. /~E Parameter (Inhibit Slideshow Screen Erasure)
  3162.  
  3163.  /~E<n> - Inhibit slideshow screen erase between similar images
  3164.  
  3165.     /~E0 - Always clear the screen
  3166.     /~E1 - Don't clear the screen unless the video mode changes (faster)
  3167. :::hl/~F
  3168. /~F Parameter (Color Proximity Elimination)
  3169.  
  3170.  /~F<n> - Enable color proximity elimination in color reduction
  3171. :::hl/~G
  3172. /~G Parameter (Optimal Grayscale Palettes)
  3173.  
  3174.  /~G<n> - Generate optimized grayscale palettes (G1, default=G0)
  3175. :::hl/~J
  3176. /~J Parameter (Color Printing)
  3177.  
  3178.  /~J<n> - Print in COLOR.  HP PCL CMY process inkjet printers supported.
  3179.     /~J0 - Support black and white printing only (default)
  3180.     /~J1 - Support CMYK color PCL
  3181.  
  3182. Note:  Printing graphics is supported in enhanced versions of GDS only.
  3183. :::hl/~K
  3184. /~K Parameter
  3185.  
  3186. This option was used in version 3.0 and is no longer needed.
  3187. :::hl/~L
  3188. /~L Parameter (Dynamic File List)
  3189.  
  3190.  /~L<n> - Set initial length of dynamic file list cache size for GDS.  The
  3191.           maximum number of files GDS can handle is 2848.  The default for
  3192.           this option is 200.  You may save a very small amount of RAM by
  3193.           setting this number lower if you use GDS with fewer than 150 files
  3194.           at a time.  Setting this number to 50 will save 3450 bytes of RAM.
  3195.           As the file list grows, GDS may run out of memory, which will stop
  3196.           GDS from adding valid files to the file list.  This should not
  3197.           happen unless GDS is trying to deal with thousands of files. Paths
  3198.           are handled separately and there is no practical limit to the
  3199.           number of concurrent paths GDS can handle.
  3200. :::hl/~M
  3201. /~M Parameter (JPEG Quality)
  3202.  
  3203.  /~M<n> - Set default JPEG quality level
  3204.  
  3205.     Use values between 10 and 99.  Higher values result in better image
  3206.     quality at the expense of compression.
  3207.  
  3208.     /~M75 - Set JPEG Quality to 75 (default)
  3209.  
  3210.     *Note:    Not supported in trial shareware version.
  3211. :::hl/~O
  3212. /~O Parameter (File Sort Mode)
  3213.  
  3214.  /~O<n> - Set default file sort mode (0=name/1=size/2=bits/3=res/4=extn)
  3215. :::hl/~R
  3216. /~R Parameter (Aspect Ratio Handling)
  3217.  
  3218.  /~R<n> - Force aspect ratio of all catalog files to 1:1
  3219. :::hl/~T
  3220. /~T Parameter (Catalog File Output Format)
  3221.  
  3222.  /~TA    - Write to ANSI text (sysop/professional version only).
  3223.  /~TB    - Write to BMP
  3224.  /~TD    - Write to CUT (Dr. Halo)
  3225.  /~TI    - Write to TIFF
  3226.  /~TJ    - Write to JPG (JFIF)
  3227.  /~TL    - Write to LBM
  3228.  /~TP    - Write to PCX
  3229.  /~TR    - Write to RIX
  3230.  /~TT    - Write to TGA
  3231.  /~TW    - Write to GIF (default)
  3232.  /~TY    - Write to WPG
  3233.  
  3234.  
  3235. :::hl/~Z
  3236. /~Z Parameter (Write to Startup Path)
  3237.  
  3238.  /~Z<n> - Always try to write new files to startup path
  3239. :::hl/<vid>
  3240. /<vid> Parameter (Force Video Type)
  3241.  
  3242. This parameter avoids all video hardware autodetection and forces GDS to
  3243. assume that there is a certain type of video hardware available.  For more
  3244. information, see hlCmdVHVideo Hardware Parameters.
  3245. :::hl/512
  3246. /512 Parameter
  3247.  
  3248. This parameter forced older versions of GDS to assume that the video hardware
  3249. had at least 512K of video RAM.  This option is now obsolete because the
  3250. automatic configuration reliably detects the validity of individual modes,
  3251. including the availability of sufficient video RAM.
  3252. :::hl/1M
  3253. /1M Parameter
  3254.  
  3255. This parameter forced older versions of GDS to assume that the video hardware
  3256. had at least one megabyte of video RAM.  This option is now obsolete because
  3257. the automatic configuration reliably detects the validity of individual modes,
  3258. including the availability of sufficient video RAM.
  3259. :::hl@<file>
  3260. @<file> Parameter (Read File Spec. List)
  3261.  
  3262.  @<file> - Read file list from text file: <file>  (ie:  GDS @file.lst )
  3263. :::hl/@C
  3264. /@C Parameter (Convert Files)
  3265.  
  3266. GDS can perform all file conversion operations from the command line.  GDS
  3267. uses either XMS or disk space as a virtual file, so the resolution of the file
  3268. is not important.  This makes GDS ideal for use with on-line systems as a
  3269. simple means of providing multiple file formats for download.
  3270.  
  3271. The /@C command line parameter can be used to carry out a single conversion or
  3272. a batch conversion.  Any files which are specified to GDS are assumed to be
  3273. converted into the specified format.  If no files are specified on the command
  3274. line (or in a configuration file), then GDS assumes that all files in the
  3275. current directory are to be converted, so be careful about specifying which
  3276. files to convert.
  3277.  
  3278. The /@C command line parameter takes two additional values specified directly
  3279. after one another.  The first parameter is a letter signifying the destination
  3280. format.  The second parameter is the number of bits per pixel.  Note that some
  3281. formats do not support certain bit depths, so be sure to specify only those
  3282. combinations which are supported.
  3283. 
  3284.  /@C<t><c> - Convert files from command line
  3285. 
  3286.     <t> Destination File Type
  3287.         A = ANSI    P = PCX
  3288.         B = BMP        R = ColorRIX
  3289.         D = CUT/PAL    T = TGA
  3290.         I = TIFF    W = GIF
  3291.         L = IFF/LBM    Y = WPG
  3292.         J = JPEG
  3293. 
  3294.     <c> Destination File Bit Depth (determines number of colors)
  3295.         1 = monochrome        15 = 32,768 colors
  3296.         2 = 4 colors        16 = 65,536 colors
  3297.         4 = 16 colors        24 = 16.7 million colors
  3298.         8 = 256 colors
  3299.  
  3300. For example, /@CW8 converts all specified files to 256 color GIF files, while
  3301. /@CJ24 converts them to 24 bit JPEG files.  Note that /@CJ8 is not legal,
  3302. because color JPEG files are always considered to be 24 bits.  The following
  3303. combinations are valid:
  3304. 
  3305.     hlConvANSI/@CA    (ANSI, 16 color text)
  3306.     hlConvBMP1/@CB1    (BMP monochrome)
  3307.     hlConvBMP4/@CB4    (BMP 16 colors)
  3308.     hlConvBMP8/@CB8    (BMP 256 colors)
  3309.     hlConvBMP24/@CB24    (BMP 16.7 million colors)
  3310.     hlConvCUT1/@CD1    (Halo CUT/PAL monochrome)
  3311.     hlConvCUT4/@CD4    (Halo CUT/PAL 16 colors)
  3312.     hlConvCUT8/@CD8    (Halo CUT/PAL 256 colors)
  3313.     hlConvJPG24/@CJ24    (JPEG 16.7 million colors)
  3314.     hlConvGIF1/@CW1    (GIF monochrome)
  3315.     hlConvGIF4/@CW4    (GIF 16 colors)
  3316.     hlConvGIF8/@CW8    (GIF 256 colors)
  3317.     hlConvLBM1/@CL1    (LBM/IFF monochrome)
  3318.     hlConvLBM4/@CL4    (LBM/IFF 16 colors)
  3319.     hlConvLBM8/@CL8    (LBM/IFF 256 colors)
  3320.     hlConvPCX1/@CP1    (PCX monochrome)
  3321.     hlConvPCX4/@CP4    (PCX 16 colors)
  3322.     hlConvPCX8/@CP8    (PCX 256 colors)
  3323.     hlConvRIX4/@CR4    (ColorRIX 16 colors)
  3324.     hlConvRIX8/@CR8    (ColorRIX 256 colors)
  3325.     hlConvTIF1/@CI1    (TIFF monochrome)
  3326.     hlConvTIF4/@CI4    (TIFF 16 colors)
  3327.     hlConvTIF8/@CI8    (TIFF 256 colors)
  3328.     hlConvTIF24/@CI24    (TIFF 16.7 million colors)
  3329.     hlConvTGA15/@CT15    (TGA 32K colors)
  3330.     hlConvTGA24/@CT24    (TGA 16.7 million colors)
  3331.     hlConvWPG1/@CY1    (WPG monochrome)
  3332.     hlConvWPG4/@CY4    (WPG 16 colors)
  3333.     hlConvWPG8/@CY8    (WPG 256 colors)
  3334.  
  3335. If GDS can write the output files without overwriting a file with the same
  3336. name, then the default file name will be preserved.  If files with the same
  3337. name are found, then GDS will write out those files with a filename like
  3338. GDS000, GDS001, GDS002, etc.
  3339. 
  3340. See also: hlConvMenuUsing the Convert Menu, hlHowToConvertConverting Files,
  3341.     hlViewWriteConverting via View Menus, hlViewModeMenuView Mode File Menu
  3342.     hlViewWriteConverting via View Menus, hlViewModeMenuView Mode File Menu
  3343.  
  3344.  
  3345. :::hlFormats
  3346. SUPPORTED FILE FORMATS
  3347.  
  3348. Photodex is constantly making adjustments and upgrades to the file format
  3349. support in GDS.  If you encounter any incompatibilities with files, please
  3350. hlPhotodexcontact us.
  3351.  
  3352. GDS supports the following file formats:
  3353.  
  3354.             Bit Depth (* = R&W)
  3355. Ext.    Read    Write    1 2 4 8 15 16 24 32    Description
  3356. ────    ────    ─────    ───────────────────    ───────────
  3357. .ANS    Yes    Yes    - - (text mode) - -    Color ANSI text (BBS)
  3358. .TXT    Yes    Yes    - - (text mode) - -    Generic text (ANSI opt.)
  3359. .BBM    Yes    Yes    *   * *    Rd Rd ** Rd    Deluxe Paint (IFF 'Brush')
  3360. .BMP    Yes    Yes    *   * *       **    Microsoft Windows Bitmap
  3361. .CUT    Yes    Yes    *   * *            Media Cybernetics (HALO)
  3362. .FLI     <externl>    <N/A>            AutoDesk (QUICKFLI.EXE)
  3363. .GDS    Yes    Yes    * R R *    Rd Rd ** Rd    Raxsoft/Photodex Scanning
  3364. .GIF    Yes    Yes    * * * *            CompuServe GIF87/GIF89a
  3365. .GL     <externl>    <N/A>            Grasp (GRASPRT.EXE)
  3366. .HAM    Yes    Yes    *   * * Rd Rd ** Rd    Electronic Arts (IFF/HAM)
  3367. .IFF    Yes    Yes    *   * * Rd Rd ** Rd    Electronic Arts (IFF/HAM)
  3368. .JPG    Yes    Yes          R          ** Rd    JPEG (standard JFIF)
  3369. .LBM    Yes    Yes    *   * *    Rd Rd ** Rd    Deluxe Paint (IFF/HAM)
  3370. .MAC    Yes     -    R            Macintosh MacPaint Mono
  3371. .PCC    Yes    Yes    * R * *          Rd    ZSoft PC Paintbrush 'Brush'
  3372. .PCX    Yes    Yes    * R * *          **    ZSoft PC Paintbrush
  3373. .RAX    Yes    Yes    * R * *    **    ** Rd    Raxsoft/Photodex VideoGames
  3374. .RFX    Yes    Yes    * R * *    **    ** Rd    Raxsoft/Photodex Fonts
  3375. .RLE    Yes     -    R   R R       Rd    Windows RLE Bitmap
  3376. .SC*    Yes    Yes        * *            ColorRIX
  3377. .TGA    Yes    Yes          R    **    ** Rd    Truevision Targa
  3378. .TIF    Yes    Yes    * R * *    Rd Rd ** Rd    Tagged Image File Format
  3379. .WPG    Yes    Yes    * R * *            WordPerfect Graphics (Bitmap)
  3380.  
  3381. Note that many bit depths are meaningless in most formats, so blanks above
  3382. do not necessarily indicate a deficiency in the support for the format.
  3383.  
  3384. JPEG and TIFF files can be stored in CMYK format, which GDS automatically
  3385. converts to 24 bit RGB for processing.
  3386.  
  3387. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  3388. IFF files, and there are even books available incorrectly describing how IFF
  3389. works.  Adobe Photoshop and Graphics Workshop (and perhaps other programs)
  3390. appear to read IFF/LBM/HAM files incorrectly, and may write incorrectly
  3391. compressed IFF files also.  Please be careful to follow Electronic Arts' IFF
  3392. specifications precisely.
  3393.  
  3394.  
  3395. :::hlViewModeMenu
  3396. View Mode Menus
  3397.  
  3398. When viewing an image the following View Mode Menus can be accessed by
  3399. clicking the mouse button while the cursor is near the top edge of the
  3400. screen.  If you do not select an option when releasing the mouse button,
  3401. the view mode menus disappear and you are returned harmlessly to viewing
  3402. the current image file.
  3403.  
  3404. Note:  There is no way to access View Mode Menus without a mouse.  Most
  3405. options in the View Mode Menus have keyboard equivalents which are listed
  3406. in each menu.
  3407.  
  3408. hlViewModeMenuFile File  hlViewModeMenuEdit Edit  hlViewModeMenuColor Color  hlViewModeMenuSize Size  hlViewModeMenuPrint Print  hlViewModeMenuRes (Resolution) 
  3409.  
  3410.  
  3411. :::hlViewModeMenuFile
  3412. View Mode File Menu
  3413.  
  3414. The View Mode File Menu is used to write the displayed image (or a cropped
  3415. portion of the image) to an image file, and to set the cropping rectangle,
  3416. as well as obtaining file information and exiting View Mode.  (Note that it
  3417. is usually much easier to exit View Mode by pressing the [Esc] key.)
  3418. 
  3419.     hlVMMFSaveANSSave ANS      Alt-A
  3420.     hlVMMFSaveGIFSave CUT/PAL      Alt-D
  3421.     hlVMMFSaveGIFSave GIF      Alt-W
  3422.     hlVMMFSaveLBMSave LBM      Alt-L
  3423.     hlVMMFSavePCXSave PCX      Alt-P
  3424.     hlVMMFSaveBMPSave BMP      Alt-B
  3425.     hlVMMFSaveRIXSave RIX      Alt-R
  3426.     hlVMMFSaveTGASave TGA      Alt-T
  3427.     hlVMMFSaveTIFSave TIF      Alt-I
  3428.     hlVMMFSaveJPGSave JPG      Alt-J
  3429.     hlVMMFSaveWPGSave WPG      Alt-Y
  3430.     -----------------------
  3431.     hlVMMFSetCropSet Cropping      Alt-C
  3432.     hlVMMFResetCropReset Cropping
  3433.     -----------------------
  3434.     hlVMMFFileInfoFile Info (?)
  3435.     -----------------------
  3436.     hlVMMFQuitQuit            Esc
  3437.  
  3438.  
  3439. :::hlVMMFSaveANS
  3440. Save ANSI 16 Color Text File
  3441.  
  3442. Selecting this option from the View Mode File Menu (or hitting [Alt-A]) will
  3443. create a file using the entire screen image or a portion of the screen image
  3444. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3445. be dithered down to the standard 16 color ANSI palette and size (79
  3446. characters wide. 
  3447.  
  3448. This function is supported in GDS Professional
  3449.  
  3450. :::hlVMMFSaveGIF
  3451. Save GIF (CompuServe GIF89a) File
  3452.  
  3453. Selecting this option from the View Mode File Menu (or hitting [Alt-W]) will
  3454. create a file using the entire screen image or a portion of the screen image
  3455. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3456. be dithered down to 256 colors.
  3457.  
  3458.  
  3459. :::hlVMMFSaveLBM
  3460. Save LBM (Deluxe Paint) File
  3461.  
  3462. Selecting this option from the View Mode File Menu (or hitting [Alt-L]) will
  3463. create a file using the entire screen image or a portion of the screen image
  3464. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3465. be dithered down to 256 colors.
  3466.  
  3467.  
  3468. :::hlVMMFSavePCX
  3469. Save PCX (Paint) File
  3470.  
  3471. Selecting this option from the View Mode File Menu (or hitting [Alt-P]) will
  3472. create a file using the entire screen image or a portion of the screen image
  3473. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3474. be dithered down to 256 colors.
  3475.  
  3476.  
  3477. :::hlVMMFSaveBMP
  3478. Save BMP (Windows Bitmap) File
  3479.  
  3480. Selecting this option from the View Mode File Menu (or hitting [Alt-B]) will
  3481. create a file using the entire screen image or a portion of the screen image
  3482. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3483.  
  3484.  
  3485. :::hlVMMFSaveRIX
  3486. Save RIX (ColorRix) File
  3487.  
  3488. Selecting this option from the View Mode File Menu (or hitting [Alt-R]) will
  3489. create a file using the entire screen image or a portion of the screen image
  3490. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes
  3491. will be dithered down to 256 colors.
  3492.  
  3493.  
  3494. :::hlVMMFSaveTIF
  3495. Save TIF (Tagged Image File Format) File
  3496.  
  3497. Selecting this option from the View Mode File Menu (or hitting [Alt-I]) will
  3498. create a file using the entire screen image or a portion of the screen image
  3499. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3500.  
  3501.  
  3502. :::hlVMMFSaveTGA
  3503. Save TGA (Targa) File
  3504.  
  3505. Selecting this option from the View Mode File Menu (or hitting [Alt-T]) will
  3506. create a file using the entire screen image or a portion of the screen image
  3507. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3508.  
  3509.  
  3510. :::hlVMMFSaveJPG
  3511. Save JPG (JPEG) File
  3512.  
  3513. Selecting this option from the View Mode File Menu (or hitting [Alt-J]) will
  3514. create a file using the entire screen image or a portion of the screen image
  3515. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3516.  
  3517.  
  3518. :::hlVMMFSaveWPG
  3519. Save WPG (Word Perfect Graphics) File
  3520.  
  3521. Selecting this option from the View Mode File Menu (or hitting [Alt-Y])
  3522. creates a file using the entire screen image or a portion of the screen image
  3523. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3524.  
  3525.  
  3526. :::hlVMMFSetCrop
  3527. Set Crop Rectangle
  3528.  
  3529. Selecting Set Crop Rect. from the View Mode File Menu (or hitting [Alt-C)
  3530. will begin the crop function.  Place the mouse cursor one corner of the area
  3531. to be cropped.  Hold down the mouse button and drag the Crop Rectangle that
  3532. appears so it contains the desired area. Only the area inside the Crop
  3533. Rectangle will be saved by using one of the Save commands from the View Mode
  3534. File Menu.
  3535.  
  3536.  
  3537. :::hlVMMFResetCrop
  3538. Reset Crop Rectangle
  3539.  
  3540. Selecting this option from the View Mode File Menu will reset the hlVMMFSetCropCrop
  3541. hlVMMFSetCropRectangle to contain the entire screen area.
  3542.  
  3543.  
  3544. :::hlVMMFFileInfo
  3545. File Information
  3546.  
  3547. Selecting File Info From the View Mode File Menu (or hitting [?]) will
  3548. display helpful information about the file being viewed including the
  3549. filename, extension (file type), resolution, number of colors, and even the
  3550. total number of dots (very important!)
  3551.  
  3552.  
  3553. :::hlVMMFQuit
  3554. Quit View Mode
  3555.  
  3556. Selecting Quit form the View Mode File Menu (or hitting [Esc]) will exit View
  3557. Mode to the File List.  Also, clicking the mouse button exits except on
  3558. Catalog screens.
  3559.  
  3560.  
  3561. :::hlViewModeMenuEdit
  3562. View Mode Edit Menu
  3563. The View Mode Edit Menu provides several image functions, including rotation,
  3564. axis flipping, mouse panning and the ability to reset the orientation of the
  3565. displayed image file.
  3566. 
  3567.     hlVMMERotateRotate 90 Deg.        /
  3568.     ---------------------
  3569.     hlVMMEFlipHorzFlip Horizontal        H
  3570.     hlVMMEFlipVertFlip Vertical        V
  3571.     ---------------------
  3572.     hlVMMEPanPan Image w/Mouse   P
  3573.     ---------------------
  3574.     hlVMMEResetReset Orientation
  3575.  
  3576.  
  3577. :::hlVMMERotate
  3578. Rotate 90 Degrees
  3579.  
  3580. Selecting Rotate 90 Deg. (or hitting /) rotates the image on the screen
  3581. 90 degrees clockwise.
  3582.  
  3583.  
  3584. :::hlVMMEFlipHorz
  3585. Flip Horizontal
  3586.  
  3587. Selecting Flip Horizontal (or hitting H) creates a mirror image of the
  3588. file displayed on the screen.
  3589.  
  3590.  
  3591. :::hlVMMEFlipVert
  3592. Flip Horizontal
  3593.  
  3594. Selecting Flip Horizontal (or hitting H) creates a vertical mirror image
  3595. of the file displayed on the screen.
  3596.  
  3597.  
  3598. :::hlVMMEPan
  3599. Pan Image with Mouse
  3600.  
  3601. Selecting Pan Image w/Mouse (or hitting P) puts GDS in panning mode. Hold
  3602. down the mouse button and move the mouse to pan the image on the screen. When
  3603. the mouse button is released GDS will exit panning mode.
  3604.  
  3605.  
  3606. :::hlVMMEReset
  3607. Reset Orientation
  3608.  
  3609. Selecting Reset Orientation undoes all other View Mode Edit Menu commands
  3610. restoring an image to its original orientation.
  3611.  
  3612.  
  3613. :::hlViewModeMenuColor
  3614. View Mode Color Menu
  3615.  
  3616. The View Mode Color Menu is used to manipulate the color content of the
  3617. current image file.  Note that this menu has no effect in video modes with
  3618. 15, 16 or 24 bits per pixel (32k, 64k and 16.7 million colors), although
  3619. it will still allow the user to select from it.
  3620.  
  3621.     hlVMMCGrayGrayscale
  3622.     hlVMMCmaxMaximum Color
  3623.     -----------------------
  3624.     hlVMMCInvertInvert Palette          '
  3625.     -----------------------
  3626.     hlVMMCResetColorReset Color Intensity <
  3627.     hlVMMCResetAllReset All Settings
  3628.  
  3629.  
  3630. :::hlVMMCGray
  3631. Grayscale
  3632.  
  3633. Selecting Grayscale converts a color image into shades of gray. This
  3634. command has no effect if using a screen mode supporting more than 256 colors.
  3635.  
  3636.  
  3637. :::hlVMMCMax
  3638. Maximum Color
  3639.  
  3640. Selecting Maximum Color saturates the colors in an image. This command
  3641. has no effect if using a screen mode supporting more than 256 colors.
  3642.  
  3643.  
  3644. :::hlVMMCInvert
  3645. Invert Palette
  3646.  
  3647. Selecting Invert Palette (or hitting ~) creates a "negative" version of an
  3648. image. This command has no effect if using a screen mode supporting more than
  3649. 256 colors.
  3650.  
  3651.  
  3652. :::hlVMMCResetColor
  3653. Reset Color Intensity
  3654.  
  3655. Selecting Reset Color Intensity (or hitting <) reverts all View Mode Color
  3656. Menu options to their original state.
  3657.  
  3658.  
  3659. :::hlVMMCResetAll
  3660. Reset All Setting
  3661.  
  3662. Selecting Reset All Settings reverts all View Mode options to their original
  3663. state. The spacebar also restores an image to its original state.
  3664.  
  3665.  
  3666. :::hlViewModeMenuSize
  3667. View Mode Size Menu
  3668.  
  3669. The View Mode Size Menu provides size alteration and positioning of the
  3670. current image file.
  3671.  
  3672.     hlVMMSFitFit To Screen     Alt-F
  3673.     hlVMMSSetZoomSet Zoom Rect.     Alt-Z
  3674.     ----------------------
  3675.     hlVMMSDoubleXDouble X
  3676.     hlVMMSDoubleYDouble Y
  3677.     hlVMMSDoubleXYDouble Both X/Y
  3678.     ----------------------
  3679.     hlVMMSHalfXHalf X
  3680.     hlVMMSHalfYHalf Y
  3681.     hlVMMSHalfXYHalf Both X/Y
  3682.     ----------------------
  3683.     hlVMMSCenterCenter Image     Alt-S
  3684.     ----------------------
  3685.     hlVMMSResetReset Scale Parameters
  3686.  
  3687.  
  3688. :::hlVMMSFit
  3689. Fit Image to Screen
  3690.  
  3691. Selecting Fit To Screen (or hitting [Ctrl-F]) changes an image smaller or
  3692. larger than the current screen mode to match the dimensions of the screen.
  3693.  
  3694.  
  3695. :::hlVMMSSetZoom
  3696. Set Zoom Rectangle
  3697.  
  3698. Selecting Set Zoom Rectangle (or hitting [Alt-Z]) places GDS in zoom mode.
  3699. Move the mouse cursor to one corner of the area to be zoomed. Hold down the
  3700. mouse button and drag the mouse until the desired area is within the Zoom
  3701. Rectangle. Release the mouse button and GDS zoom the selected area to fill
  3702. the screen.
  3703.  
  3704. Related Topics
  3705.     hlVMCZoomOMaticInstant Zoom (Zoom'O'Matic)
  3706.  
  3707.  
  3708. :::hlVMMSDoubleX
  3709. Double X
  3710.  
  3711. Selecting this option will double the width of an image.
  3712.  
  3713.  
  3714. :::hlVMMSDoubleY
  3715. Double Y
  3716.  
  3717. Selecting this option will double the height of an image.
  3718.  
  3719.  
  3720. :::hlVMMSDoubleXY
  3721. Double X and Y
  3722.  
  3723. Selecting this option will double the height and width of an image.
  3724.  
  3725.  
  3726. :::hlVMMSHalfX
  3727. Half X
  3728.  
  3729. Selecting this option will halve the width of an image.
  3730.  
  3731.  
  3732. :::hlVMMSHalfY
  3733. Half Y
  3734.  
  3735. Selecting this option will halve the height of an image.
  3736.  
  3737.  
  3738. :::hlVMMSHalfXY
  3739. Half X and Y
  3740.  
  3741. Selecting this option will halve the height and width of an image.
  3742.  
  3743.  
  3744. :::hlVMMSCenter
  3745. Center Image
  3746.  
  3747. Selecting Center Image (or hitting [Ctrl-S]) places the displayed image in
  3748. the center of the screen.
  3749.  
  3750.  
  3751. :::hlVMMSReset
  3752. Reset Scale Parameters
  3753.  
  3754. Selecting Reset Scale Parameters reverts all View Mode Size
  3755. Menu options to their original state.
  3756.  
  3757.  
  3758. :::hlViewModeMenuPrint
  3759. View Mode Print Menu
  3760.  
  3761. The print menu allows you to print the currently displayed image file (or a
  3762. portion selected with the Alt-C function) directly from the screen.  Note
  3763. that graphics printing is supported only by registered versions of GDS.
  3764.  
  3765.            hlVMMPPrintPrint Portrait
  3766.     hlVMMPPrintPrint Landscape
  3767.  
  3768. Note:  Printing graphics is supported in enhanced versions of GDS only.
  3769.  
  3770. :::hlVMMPPrint
  3771. Print Portrait or Landscape
  3772.  
  3773. These menu options will print the currently hlHowToSelectselected file in either portrait
  3774. (10" tall) or landscape (10" wide) mode on HP LaserJets, DeskJets and 100%
  3775. compatible PCL printer language printers.  Additionally, GDS will print in
  3776. color on the DeskJet 500C, 550C, 560C, and 1200C.  The correct port must be
  3777. selected in the Setup Menu: Printer On... section.
  3778.  
  3779. Note:  Printing graphics is supported in enhanced versions of GDS only.
  3780.  
  3781. :::hlViewModeMenuRes
  3782. View Mode Resolution Menu
  3783.  
  3784. The Viewmode Resolution Menu lists the current video resolution on the menu
  3785. bar.  The video mode may be changed by selecting a different video resolution
  3786. from this menu.  From top to bottom, the menu is organized into sections of
  3787. similar numbers of colors (bit depths), and then by resolution within each
  3788. section.
  3789.  
  3790. *Note:  GDS does NOT display the current video mode in the resolution menu,
  3791.     because doing so would be pointless, and would waste space which
  3792.     can be better used for a different possible resolution.
  3793.  
  3794. GDS can display up to 25 modes in the resolution menu.  Because they are
  3795. sorted by bit depth, the highest (coolest) video modes are nearest to the
  3796. top of the menu, making them more convenient to select.
  3797.  
  3798.  
  3799. :::hlHowToSelect
  3800. How To Select Files
  3801.  
  3802. Selecting files is very important because it determines files to be included
  3803. in catalogs, slideshows as well as batch conversions and printouts.
  3804.  
  3805. File selection is simple; just click with the mouse and a file is selected.
  3806. Double clicking on a file initiates viewing the file, which can also be done
  3807. with the keyboard by pressing the [Enter] key.
  3808.  
  3809. There are several variations of selecting files which make things like
  3810. selecting ranges and selecting arbitrary sets of files.  The two major ways
  3811. to select files are with a mouse, and with the keyboard.  Mouse selection is
  3812. described separately from keyboard selection.
  3813.  
  3814. Mouse Selection
  3815. ───────────────
  3816.   To select a single file, move the mouse cursor over the file and click the
  3817.   mouse button.  To deselect it, click the button again.  Note that if you
  3818.   click twice, you will actually initiate viewing the image, so to deselect,
  3819.   make sure there has been about a half-second delay.
  3820.  
  3821.   To select a range of files, move the mouse over the first file, click AND
  3822.   HOLD the mouse button, and then drag the mouse to the last file and release
  3823.   the mouse button.
  3824.  
  3825.   Normally, when you click a mouse button on the file list, all currently
  3826.   selected files are deselected.  To prevent this, hold down the [Shift] key
  3827.   while performing your selections.  The [Shift] key allows you to toggle
  3828.   both single and range selections.
  3829.  
  3830. Keyboard Selection
  3831. ──────────────────
  3832.   Keyboard selection is simpler but less flexible.  Simply user the arrow
  3833.   keys to move the file cursor to the file to select and press the [Space Bar]
  3834.   key.  Each time you press the [Space Bar] key, GDS toggles the selection
  3835.   state of the highlighted file and then moves the file cursor to the next
  3836.   entry.
  3837.  
  3838.   To select a range of files, just use the arrow keys to the first file and
  3839.   then hold down the [Space Bar] until all of the files are selected.
  3840.  
  3841. Quick Letter 'Go To' Function
  3842. ─────────────────────────────
  3843.   This is an obscure function which can be very handy.  Just type a letter or
  3844.   number on the keyboard, and GDS will move to the first file in the file
  3845.   list which has a filename which begins with the same letter or a letter
  3846.   following the typed letter in the alphabet.  This function is somewhat
  3847.   defeated when the sort order is not set to hlDisplayMenuSortSort: Name Extn, but is
  3848.   useful to be aware of.
  3849.  
  3850.  
  3851. :::hlViewModeCommands
  3852. View Mode Command Reference
  3853.  
  3854. The following keyboard commands are available when viewing images.
  3855.  
  3856.     hlVMMFQuit<Esc>- Exit
  3857.   hlVMMCResetAll<Space>- Restore Original Image 
  3858.       hlVMCZoomOMatic<Z>- Zoom'O'Matic
  3859.       hlVMMFFileInfo<?>- File information
  3860.   hlVMMFSaveBMP<Alt-B>- Write .BMP (Windows Bitmap)
  3861.   hlVMMFSaveTIF<Alt-I>- Write .TIF (Tagged Image File Format)
  3862.   hlVMMFSaveLBM<Alt-L>- Write .LBM (Deluxe Paint)
  3863.   hlVMMFSavePCX<Alt-P>- Write .PCX (ZSoft PC Paintbrush)
  3864.   hlVMMFSaveSCx<Alt-R>- Write .SCx (ColorRIX)
  3865.   hlVMMFSaveTGA<Alt-T>- Write .TGA (Targa)
  3866.   hlVMMFSaveGIF<Alt-W>- Write .GIF (CompuServe GIF89a)
  3867.   hlVMMFSaveJPG<Alt-J>- Write .JPG (JPEG/JFIF format)
  3868.   hlVMMFSaveANS<Alt-A>- Write .ANS (ANSI text)
  3869.   hlVMMFSaveANS<Alt-Y>- Write .WPG (WordPerfect)
  3870.     hlVMCColorLevelF1/F2- Red level 
  3871.     hlVMCColorLevelF3/F4- Green level
  3872.     hlVMCColorLevelF5/F6- Blue level
  3873.     hlVMCContrastF7/F8- Contrast
  3874.    hlVMCBrightnessF9/F10- Brightness
  3875.   hlVMCHueF11/F12- Hue
  3876.   hlVMCColorLevel','/'.'- Color level
  3877. hlVMMERotateslash '/'- Rotate 90 degrees
  3878. hlVMMCInverttilde '~'- Invert palette
  3879.       hlVMMEFlipHorz'H'- Flip Horizontal
  3880.       hlVMMEFlipVert'V'- Flip Vertical
  3881.       hlVMMEPan'P'- Pan image with mouse.
  3882.  hlVMCScaleplus '+'- Scale image up 5% larger
  3883. hlVMCScaleminus '-'- Scale image down 5% smaller
  3884.   hlVMMSFit<Alt-F>- Fit image to screen
  3885.   hlVMMSCenter<Alt-S>- Center image
  3886.   hlVMMFSetCrop<Alt-C>- Set "crop" rectangle
  3887.   hlVMMSSetZoom<Alt-Z>- Set "zoom" rectangle
  3888.    hlVMCArrowArrows- Resize Image
  3889. hlVMCKeyboardPan   <E>     
  3890. hlVMCKeyboardPan         
  3891. hlVMCKeyboardPan<S>-■-<D>- Keyboard panning 
  3892. hlVMCKeyboardPan          
  3893. hlVMCKeyboardPan   <X>     
  3894.   hlVMCSharp<PgUp> - Increase sharpening
  3895.   hlVMCSharp<PgDn> - Decrease sharpening
  3896.      hlVMCQuote<'> - Undocumented quote function
  3897.  
  3898.  
  3899. :::hlVMCZoomOMatic
  3900. Zoom'O'Matic
  3901.  
  3902.       [Z]- Zoom'O'Matic for 2-256 color displays.  (Requires XMS)
  3903. 
  3904.              While zooming:  * Mouse pans the image in real-time
  3905.                              * Up and down arrows increase and decrease zoom
  3906.                              * Number keys (1-9) set zoom magnification level
  3907.                              * Any other key or mouse button exit zoom mode
  3908. :::hlVMCColorLevel
  3909. View Mode Color Adjustments
  3910.  
  3911. These keys adjust the appearance of an image while viewing.
  3912.  
  3913.     F1/F2- Red level    Use <Shift> to reset
  3914.     F3/F4- Green level   "
  3915.     F5/F6- Blue level    "
  3916.     , / .- Color level   "
  3917.  
  3918.     *Note:    These keys may not work if the video mode supports more
  3919.         than 256 colors.
  3920.  
  3921. :::hlVMCContrast
  3922. View Mode Contrast Adjustment
  3923.  
  3924. These keys adjust the variation between light and dark areas of an image.
  3925.  
  3926.     F7/F8- Contrast      Use <Shift> to reset
  3927.  
  3928.     *Note:    These keys may not work if the video mode supports more
  3929.         than 256 colors.
  3930.  
  3931. :::hlVMCBrightness
  3932. View Mode Brightness Adjustment
  3933.  
  3934. These keys brighten or darken an image.
  3935.  
  3936.     F9/F10- Brightness   Use <Shift> to reset
  3937.  
  3938.     *Note:    These keys may not work if the video mode supports more
  3939.         than 256 colors.
  3940.  
  3941. :::hlVMCHue
  3942. View Mode Hue Adjustment
  3943.  
  3944. These keys alter the hue of an image.
  3945.  
  3946.   F11/F12- Hue        Use <Shift> to reset           
  3947.  
  3948.     *Note:    These keys may not work if the video mode supports more
  3949.         than 256 colors.
  3950.  
  3951. :::hlVMCScale
  3952. View Mode Image Scaling
  3953.  
  3954. These keys alter the size of an image either larger or smaller and maintains
  3955. the aspect ratio.
  3956.  
  3957.  plus '+'- Scale image up 5% larger
  3958. minus '-'- Scale image down 5% smaller
  3959.  
  3960. Related Topics
  3961.     hlVMCArrowArrow Keys (in View Mode)
  3962.     hlVMMSDoubleXYDouble X/Y (from hlViewModeMenuSizeView Mode Size Menu) 
  3963.     hlVMMSHalfXYHalf X/Y (from hlViewModeMenuSizeView Mode Size Menu)
  3964.  
  3965.  
  3966. :::hlVMCArrow
  3967. View Mode Arrow Keys
  3968.  
  3969. Use the arrows to move the lower right corner of the image around.  Hold down
  3970. the <Shift> key to move 20 pixels rather than one each. Using these keys will
  3971. not maintain the aspect ratio of an image. To maintain the aspect ratio use
  3972. the hlVMCScale+ and - keys instead.
  3973.  
  3974. Related Topics
  3975.     hlVMCScale+ (Plus) and - (Minus) keys (in View Mode)
  3976.     hlVMMSDoubleXYDouble X/Y (from hlViewModeMenuSizeView Mode Size Menu) 
  3977.     hlVMMSHalfXYHalf X/Y (from hlViewModeMenuSizeView Mode Size Menu)
  3978.  
  3979.  
  3980. :::hlVMCKeyboardPan
  3981. Panning an Image from the Keyboard
  3982.  
  3983. These keys pan the image up, down, left, and right.  If the <Shift>
  3984. key is held, then they pan the image 20 pixels rather than one.
  3985. 
  3986.               Pan Up
  3987. 
  3988.                <E>
  3989.                 
  3990.            Pan Left    <S>-■-<D> Pan Right
  3991.                       
  3992.                <X>
  3993. 
  3994.              Pan Down
  3995. 
  3996. Related Topics
  3997.     hlVMMEPanPan Image with Mouse (from hlViewModeMenuEditView Mode Edit Menu)
  3998.  
  3999.  
  4000. :::hlVMCSharp
  4001. View Mode Sharpening
  4002.  
  4003. These keys increase or decrease the level of sharpening on images with more
  4004. than 256 colors (15, 16, or 24 bit color)
  4005.  
  4006.   <PgUp> - Increase sharpening
  4007.  
  4008.   <PgDn> - Decrease sharpening
  4009.  
  4010.  
  4011. :::hlVMCQuote
  4012. Undocumented Quote Feature
  4013.  
  4014.      <'> - Undocumented quote function.  Use with free spirit.
  4015.  
  4016. :::hlBBS
  4017. Cataloging a BBS with GDS
  4018.  
  4019. GDS is used by hundreds of BBS system operators around the world to manage,
  4020. verify, review, categorize and catalog thousands of graphics files.  GDS has
  4021. many functions specifically designed for BBS system operators (sysops), which
  4022. not only make these tasks easier, but can add features to an existing BBS.
  4023.  
  4024. GDS's Special BBS Features
  4025.    ■ Instantly view new graphics files, delete junk and move good files.
  4026.  
  4027.    ■ Catalog CD's to quickly see if content is worth anything.
  4028.  
  4029.    ■ Catalog downloadable graphics files and provide catalogs to callers.
  4030.      Note:  BBS users love this offering, see the section below about BBS
  4031.      file catalogs for details about how to determine what's right for
  4032.      your system.
  4033.  
  4034.    ■ Insert your system logo graphic into GDS catalogs automatically.  There
  4035.      are even systems which have random batch files which vary the logo and
  4036.      placement in order to provide variety.
  4037.  
  4038.    ■ Provide on-line tagged file cataloging.  GDS has a special standardized
  4039.      user interface designed to insert into an existing BBS.  Several BBS
  4040.      developers are putting specific hooks as well.
  4041.  
  4042.    ■ Customize system to use GDS as a tool, both for user and system
  4043.      functions.  GDS provides hundreds of command line and batch functions
  4044.      which can be easily incorporated into an existing BBS.
  4045.  
  4046.    ■ GDS Professional instantly converts graphics files to ANSI via command
  4047.      line parameters, so users can get an ANSI preview of a graphic file
  4048.      within 10 seconds to help them decide to download it.
  4049.  
  4050. There are many reasons to provide catalogs of your system.  First, users love
  4051. it because they can avoid online time and get to just the graphics files which
  4052. look interesting.  This clears your phone lines and allows you to get more
  4053. users on the system.
  4054.  
  4055. Catalogs give you a competitive edge against text-only systems.  Many users of
  4056. BBS systems are frustrated that they do not have a way to preview a large file
  4057. before they commit to a download.  With GDS catalogs, they can commit to the
  4058. catalog download, and then know roughly what to expect when they commit to a
  4059. file download.
  4060.  
  4061. There are many ways to provide catalogs, because there are many preferences
  4062. and organization structures that BBS systems use to categorize files.  The
  4063. methods which work best are as follows:
  4064.  
  4065.    ■ Decide on a standard look for your catalogs.  Consistency and uniqueness
  4066.      will eventually become a successful BBS's calling card.
  4067.  
  4068.    ■ Provide a section which catalogs all areas of the BBS.  Even if you have
  4069.      thousands of graphics files in hundreds of areas, users still one to have
  4070.      a "one stop shop" type of area on a BBS.  Don't try to make lots of areas
  4071.      with lots of catalog runs.
  4072.  
  4073.    ■ Use 25 or more pictures per catalog screen, and try to provide both GIF
  4074.      and JPEG format.  Users with 15, 16 or 24 bit displays really appreciate
  4075.      JPEG catalogs, and JPEG catalogs are much smaller than their GIF cousins.
  4076.  
  4077.    ■ Consider providing very dense catalogs for people who want a quick
  4078.      overview of a huge amount of files.  For example, you may want to have a
  4079.      run of catalogs which has 100 thumbnails per screen at 1024x768 or
  4080.      1280x1024.  This gives power users the ability to use the "brute force"
  4081.      that makes them feel more powerful.  They appreciate this "high end"
  4082.      attention and will rave about your efforts.  Once again, use JPEG to get
  4083.      the file size down!
  4084.  
  4085.    ■ Provide ANSI conversion of graphics files.  ANSI files are small and can
  4086.      be displayed by nearly all text terminal programs with no changes.
  4087.  
  4088.    ■ Consider adding options to provide single thumbnail download.  GDS can
  4089.      generate a 160x120 JPEG thumbnail of a GIF file in about 4 seconds,
  4090.      which can be downloaded to the user in about 7 seconds.  A user could
  4091.      select a file and have a thumbnail to review within 15-20 seconds.
  4092.  
  4093.  
  4094. :::hlOFrm
  4095. GDS PURCHASE ORDER AND REGISTRATION FORM
  4096. I would like a copy of GDS!  I understand that I will receive a
  4097. personalized copy, registered in my name, that I may freely use for any
  4098. personal purpose that I wish.  I also understand that GDS is protected
  4099. by Federal Copyright Laws and International Treaty Provisions and will
  4100. not copy or distribute GDS or any part of GDS.  I understand that my
  4101. correct phone number is required for registration and will be kept
  4102. strictly confidential.  Items marked with an asterisk (*) are optional.
  4103.  
  4104. Name of user:_________________________________________________________
  4105. (PLEASE PRINT CLEARLY)    First Name,  Initial,  Last name
  4106.  
  4107. *Company:_____________________________ *Work: (______) ______-________
  4108.  
  4109. Addr:_________________________________  Home: (______) ______-________
  4110.  
  4111.      _________________________________
  4112.                                             *Favorite Pop Star:_______
  4113.      _________________________________
  4114.  
  4115. City:_____________________________ State/Prov:_________ Zip:__________
  4116.  
  4117. READ THE FOLLOWING AND TRUTHFULLY MARK ONE OF THE TWO BOXES BELOW:
  4118. [_] I DO control a bulletin board system (BBS).  I understand that any
  4119. purchased copy of GDS is not in the public domain, and is not to be
  4120. made available for download by users of my or any other BBS.  I
  4121. understand that making such files available for download could result
  4122. in legal action of up to $100,000 per infraction.  To certify that I
  4123. understand this clause, I hereby write my initials:___________________
  4124. [_] I DO NOT control a BBS and will not upload purchased software to
  4125. any BBS.
  4126. ------------------------------------------QTY---PRICE----TOTAL---
  4127. ___GDS Program and Documentation          ___  $39.95  $_________
  4128.  
  4129.            Shipping and Handling          _1_   $3.00  $_____3.00
  4130.  
  4131. ___*Picture Factory for Windows (10% off!)___  $44.95  $_________
  4132.    (2,659 full color photos on CD-ROM)
  4133.  
  4134. ___*Faster shipping (2-day UPS BLUE/48 States)  $5.00  $_________
  4135.  
  4136. ___International Shipping (call for shipping charge)   $_________
  4137.    NOTE: Foreign (non-US) check orders are not accepted.
  4138.  
  4139. __VISA __MasterCard __CHECK ENCL.  (8.25% CA Sales Tax)$_________
  4140. -----------------------------------------------------------------
  4141. ________/________/________/________ Ex:____/____  TOTAL$
  4142.                                                         =========
  4143. Sign:X___________________________*Ship FED/X #:__________________
  4144.  
  4145.       ORDERS VIA MAIL                 VISA/MC ORDERS VIA FAX
  4146.   Enclose check and mail to:      Fill out completely and FAX to:
  4147.                                        +--------------------+
  4148.     Photodex Corporation               |(510) 449-3519 - FAX|
  4149.     1781 Barcelona Street              +--------------------+
  4150.     Livermore, CA  94550               (510) 449-9079 - voice
  4151. :::hlConf
  4152. GDS VIDEO MODE CONFIGURATION
  4153.  
  4154. For help with this help message, press hlHelpF1] now.
  4155.  
  4156. Welcome to GDS's Video Configuration.  If this is the first time you have
  4157. configured GDS, then we recommend you take a minute or two to read about the
  4158. configuration process before you begin.
  4159.  
  4160.     hlConfTopUnderstanding GDS Configuration  <-- Click for more
  4161.     hlConfPUPower User Quick-Start    <-- Power User's Click Here
  4162.  
  4163. If you are ready to continue, select the message below.
  4164.  
  4165.     kCrStart Configuration    <-- Select to Start Configuration
  4166.  
  4167. :::hlConfTop
  4168. Configuration Help
  4169.  
  4170. The GDS Configuration process tests all available video modes for proper
  4171. operation.  Thanks to the this process, GDS does not suffer from the most
  4172. common problems other DOS graphics programs exhibit.
  4173.  
  4174. If you have trouble configuring GDS, call hlPhotodex(510) 449-9079 for technical help.
  4175. If you FAX us at hlPhotodex(510) 449-3519, we will respond as fast as possible.
  4176.  
  4177.     hlConfPUPower User Quick-Start
  4178.  
  4179. Helpful Information
  4180.     hlConfInstHow To Configure GDS
  4181.     hlConfTestHow Each Mode is Tested
  4182.     hlConfFileGDS Configuration Files
  4183.  
  4184. Common Problems
  4185.     hlConfVideoVESA, Mode Types, Missing Modes
  4186.     hlConfReptRepeated Configurations
  4187.     hlConfCrashCrashing Video Modes
  4188.     hlConfQuirksConfiguration Quirks
  4189.     hlConfLaptopCommon Laptop/Notebook Problems
  4190.  
  4191. :::hlConfLaptop
  4192. Common Laptop/Notebook Problems
  4193.  
  4194. Many laptop and notebook computers have Cirrus Logic chipsets which GDS does
  4195. not detect.  Try using /CL54 on the command line.
  4196.  
  4197. Some laptop and notebook computers crash when GDS tries to bring up the
  4198. configuration because of incompatibility with very old CGA and EGA modes.  If
  4199. you have a laptop, try using the following switches:
  4200. 
  4201.   /LAPTOP   Disable Herc, CGA and EGA (same as /NOHERC /NOCGA /NOEGA)
  4202. 
  4203.   /NOHERC   Disable Hercules monochrome mode
  4204.   /NOCGA    Disable all CGA modes
  4205.   /NOEGA    Disable all EGA modes
  4206. 
  4207.   /NOMONO   Disable all monochrome modes
  4208. :::hlConfVideo
  4209. VESA, Mode Types & Missing Modes
  4210.  
  4211. GDS supports four types of graphics modes: standard video modes, tweeked VGA
  4212. modes, VESA modes and other non-standard modes.  Standard modes work on all
  4213. VGA cards.  Many video provide VESA support, although we have NEVER seen a
  4214. complete VESA implementation, and some video cards require the user to load
  4215. VESA drivers in order to actually use the modes.  Most VESA cards work well
  4216. enough for GDS to be able to reliably detect and support the available video
  4217. modes.
  4218.  
  4219. If you have a VESA video card and GDS is not recognizing one or more of the
  4220. video modes that the card is supposed to be able to support, you may need to
  4221. load a VESA driver.  In particular, Diamond video cards seem to have the most
  4222. problems with graphics software, including programs like CSHOW.
  4223.  
  4224. You can usually get a VESA driver from your video card or computer
  4225. manufacturer.  Many video cards include a software program which supports
  4226. VESA when the video card does not support VESA by itself.
  4227.  
  4228. There are several VESA drivers available on local BBS systems, CompuServe,
  4229. America Online and GEnie, such as UniVESA (UVBE*.ZIP).  UniVESA has been
  4230. reported to us to cause incomplete VESA support and some compatibility
  4231. problems after running Windows with some video cards.  We have been unable
  4232. to determine the extent of UniVESA's support except that it works well for
  4233. some video systems.
  4234.  
  4235. Standard Modes:
  4236.   Hercules 720x348 (Monochrome)
  4237.   CGA      640x200 (Monochrome)
  4238.        320x200 (4 color)
  4239.   EGA       320x200, 640x200, 640x350 (16 color)
  4240.   VGA       640x480 (Monochrome)
  4241.        640x480 (16 color)
  4242.        320x200 (256 color)
  4243.  
  4244. Tweeked VGA Modes:
  4245.   VGA       320x240, 320x400, 360x480 (256 color)
  4246.  
  4247. VESA Modes
  4248.   VESA       800x600, 1024x768, 1280x1024 (16 color)
  4249.        640x400, 640x480, 800x600, 1024x768, 1280x1024 (256 color)
  4250.        320x200, 640x480, 800x600, 1024x768, 1280x1024 (32768 colors)
  4251.        320x200, 640x480, 800x600, 1024x768, 1280x1024 (65536 colors)
  4252.        320x200, 640x480, 800x600, 1024x768, 1280x1024 (16 million colors)
  4253.  
  4254. Other Non-Standard Modes:
  4255.   These modes occur on video cards that are detected to have specific support
  4256.   capabilities, and the list is really long.  If you are interested, please
  4257.   refer to the end of the GDS.TXT file, which should give you a lot of
  4258.   information about video modes.
  4259.  
  4260. Related Topics
  4261.     hlConfDiamondDiamond Video Cards
  4262.     hlConfOrchidOrchid Video Cards
  4263.     hlConfATIATI Video Cards (Mach 32)
  4264.  
  4265. :::hlConfFile
  4266. GDS Configuration Files
  4267.  
  4268. GDS configures runtime defaults using configuration files called GDSUSER.CFG
  4269. and GDSLOCAL.CFG.
  4270.  
  4271. GDSUSER.CFG is the main configuration file for GDS.  Any command line
  4272. parameter GDS is capable of taking can be placed in GDSUSER.CFG by specifying
  4273. the parameter on a line preceeded by "auto,".  For example,
  4274. 
  4275.     ------- (top of GDSUSER.CFG)
  4276. 
  4277.     auto,/QUIET        ;this line disables the opening screen
  4278. 
  4279.     ------- (bottom of GDSUSER.CFG)
  4280.  
  4281. You can also put more than one command line parameter per line, as follows:
  4282. 
  4283.     auto,/QUIET /A0        ;this line disables the opening screen and
  4284.                 ;disables antialiasing
  4285.  
  4286. Any semicolon (';') on a line in a configuration file tells GDS to ignore
  4287. everything following the semicolon.  This is handy to remove configuration
  4288. options temporarily without deleting the lines:
  4289. 
  4290.     ;auto,/QUIET /A0    ;this line now does nothing
  4291.  
  4292. Semicolons are great for adding comments to configuration lines (as in the
  4293. above examples.)  These Semicolons are sometimes called "comment characters."
  4294. You can use comment character to help you switch quickly between differing
  4295. configurations, as in the following example:
  4296. 
  4297.     auto,/#LPT1 /~J0    ;use the monochrome laser printer
  4298.     ;auto,/#LPT2 /~J1    ;use the color inkjet printer
  4299.  
  4300. With these two lines, you can switch between two printers by just moving the
  4301. semicolons, and commenting out alternate lines:
  4302. 
  4303.     ;auto,/#LPT1 /~J0    ;use the monochrome laser printer
  4304.     auto,/#LPT2 /~J1    ;use the color inkjet printer
  4305.  
  4306. The first example above would print using a monochrome laser printer on LPT1.
  4307. The second example would support a color inkjet printer on LPT2.
  4308.  
  4309. It may be useful to just put a general comment in the file, which you can do
  4310. like this:
  4311. 
  4312. ;These lines are just ignored
  4313. ;by GDS when it starts up, and
  4314. ;it doesn't really waste any time
  4315. ;at startup.
  4316.  
  4317. When GDS starts up, it searches first for video mode information, then for
  4318. GDSUSER.CFG, and finally for GDSLOCAL.CFG.  When the same parameter is
  4319. encountered more than once, the last parameter takes precedence.
  4320. GDSLOCAL.CFG has the "last say" for which parameters are actually used.  It
  4321. is common to have configuration options in GDSLOCAL.CFG which override the
  4322. parameters in GDSUSER.CFG.
  4323.  
  4324. GDS searches for these files by first looking in the directory that DOS was
  4325. logged to when GDS was invoked.  This is not necessarily the directory that
  4326. GDS is stored in.  You can completely replace GDSUSER or GDSLOCAL by starting
  4327. GDS in a directory which contains GDSUSER.CFG and/or GDSLOCAL.CFG
  4328.  
  4329. If a configuration file does not exist in the startup directory, then GDS
  4330. searches the directory containing GDS.  If the file still cannot be found,
  4331. GDS quietly assumes that it doesn't exist.  This is a slick way to force GDS
  4332. to use only the static runtime defaults shipped with the program.
  4333.  
  4334. Organizations cataloging hundreds (and thousands) of files find it invaluable
  4335. to use GDSLOCAL.CFG to store the command line parameters for the catalog
  4336. creation.  This way, they can just start GDS from the directory containing the
  4337. file and let GDS go.
  4338.  
  4339. Related Topics
  4340.     hlHowToCLCatalogCatalogs from the Command Line
  4341.  
  4342.  
  4343. :::hlConfTest
  4344. How Each Video Mode is Tested
  4345.  
  4346. GDS performs the following tests to see if a mode works:
  4347.  
  4348. 1) Set the video mode using standard BIOS INT 10h.
  4349.  
  4350. 2) Checks several VGA registers to see if the video hardware looks as if it
  4351.    is generating graphics rather than text.
  4352.  
  4353. 3) Checks the bank selection and determines how the bank selection should be
  4354.    carried out.  Note that many VESA BIOSes have bugs in the bank selection,
  4355.    which prevents some modes from being allowable by GDS.
  4356.  
  4357. If ANY Of these automatic tests fails, GDS assumes that the mode cannot work
  4358. properly, and the mode is thrown away.  On several cards, there are runs of
  4359. modes which do not pass these tests, causing slight flicker on the screen
  4360. as GDS throws the modes away.
  4361.  
  4362. The raw technicalities of how GDS checks for these things is beyond the scope
  4363. of this text.
  4364.  
  4365.  
  4366. :::hlConfInst
  4367. How to Configure GDS
  4368.  
  4369. In order to ensure that each video mode is supported by GDS, each mode must be
  4370. tested by GDS and approved by you.  This process ensures that when GDS shows
  4371. a picture, you see it properly.
  4372.  
  4373. GDS sets each mode and analyzes it to determine if it is functioning properly.
  4374. For more information about the technical attributes of the test, see hlConfTestHow Each
  4375. hlConfTestMode is Tested.
  4376.  
  4377. You may want to read the section called hlConfQuirksConfiguration Quirks section
  4378. for help with quirky setups with some specific video hardware.
  4379.  
  4380. The configuration process is simple:
  4381.  
  4382. 1) GDS draws a test pattern for each screen mode and allows you to type [Y] or
  4383.    [N] for "Yes" or "No".  If a mode looks ok, then press [Y] after you hear
  4384.    the beep.
  4385.  
  4386.    If there's no beep for 15-20 seconds, the machine has crashed.  See
  4387.    hlConfCrashCrashing Modes.
  4388.  
  4389.    If the mode looks good, press [Y].  If not, see hlConfBadModeBad Looking Modes.
  4390.  
  4391. 2) When you press [Y] or [N], GDS immediately continues on to the next mode.
  4392.    This allows you to type [Y] over and over again to whiz through the
  4393.    configuration.  It is not a good idea to type [Y] before you hear the beep.
  4394.  
  4395. 3) The monitor may not be able to synchronize to all of the modes tested.  If
  4396.    the video card is capable of higher resolution modes than the monitor
  4397.    supports, then the screen may scroll in various directions, shear, move
  4398.    around and flicker.
  4399.  
  4400.    Check the utilities which come with your video card.  Some cards support
  4401.    lower resolution monitors by supporting interlaced video modes.  Older
  4402.    video cards may need to have switches set in order to support interlaced
  4403.    monitors.
  4404.  
  4405. 4) The screen may flicker between modes if GDS finds modes that your card
  4406.    does not support.  This behavior is normal.
  4407.  
  4408.    If this happens, just hit [N] when you hear the beep because the screen is
  4409.    "NOT OK TO USE".
  4410.  
  4411. When the video modes have all been approved, GDS prompts you to save the
  4412. configuration file.  It is best to save it by pressing [Enter] so you don't
  4413. have to go through the process again.
  4414.  
  4415.  
  4416. :::hlConfQuirks
  4417. Configuration Quirks
  4418.  
  4419.     hlConfDiamondDiamond Video Cards
  4420.     hlConfOrchidOrchid Video Cards
  4421.     hlConfATIATI Video Cards (Mach 32)
  4422.  
  4423. :::hlConfATI
  4424. ATI Video Cards
  4425.  
  4426. ATI video cards are known to have some problems operating in high resolution
  4427. modes because of the timing of the video RAM.  If you see flickering lines in
  4428. a display, try setting the monitor's refresh rate to a slower rate.
  4429.  
  4430. If you have any problems with this description, call ATI at (905)882-2626.
  4431. They are familiar with the problems described here, and have been helpful.
  4432. 
  4433. ATI Mach 32
  4434.     First, you must run the INSTALL program included with the ATI Mach
  4435.     32 card.  This is located on Disk 1 of 3 in the packaging.  You
  4436.     should set the startup parameters for the type of monitor you have.
  4437.     We found it most useful to use 'Customer Monitor' so we could center
  4438.     each screen mode properly (which does not work reliably, but is
  4439.     better than nothing).  When complete, the INSTALL software reboots
  4440.     your machine.
  4441.  
  4442.     Note also here that the 1280x1024x768 mode seems to be sensitive to
  4443.     the scan rate shown at the top of the screen.  If you have problems
  4444.     with this mode, go back to the install and try to use a lower scan
  4445.     rate for this mode.  (Remember to delete CONFIG again so GDS will
  4446.     reconfigure itself!)
  4447.  
  4448.     Next, add VVESA to your AUTOEXEC.BAT file.  If you do not know how
  4449.     to do this, then call ATI at the above number.  Optionally, you can
  4450.     load VVESA before you run GDS, but that's a hassle.
  4451.  
  4452.     VVESA is the ONLY support that ATI has provided for SVGA modes in
  4453.     the Mach 32 card.  For more information on this limitation, call
  4454.     ATI at the above number.
  4455.  
  4456. ATI Mach 64
  4457.     GDS automatically detects the Mach 64 and appears to run flawlessly.
  4458.     ATI appears to have overcome many problems they had with the Mach 32
  4459.     when they produced the Mach 64.  Kudos to ATI for this solid and
  4460.     very capable SVGA system.
  4461. :::hlConfOrchid
  4462. Orchid Video Cards
  4463.  
  4464. Orchid has produced many cards with BIOS bugs.  Read the section below which
  4465. matches your video card.
  4466.  
  4467. Orchid Farenheit 1280
  4468.     GDS automatically detects the Farenheit 1280 and tries to work around
  4469.     the problems with the video BIOS.
  4470.  
  4471.     If you are having problems with the F1280, call Orchid and ask for a
  4472.     BIOS upgrade.  Make sure that they check the version number of the
  4473.     BIOS with the version number printed on the BIOS chip in your card so
  4474.     everyone knows if there is a BIOS update available or not.  Some
  4475.     Photodex customers with Orchid cards have been told that there is no
  4476.     update when there was.
  4477.  
  4478. Orchid Kelvin
  4479.     GDS should work properly with this card, but there have been some
  4480.     reports of problems.  If you encounter trouble, please hlPhotodexcall.
  4481.  
  4482. :::hlConfDiamond
  4483. Diamond Video Cards
  4484.  
  4485. Diamond Computers has produced many cards with BIOS bugs.  Read the section
  4486. below which matches your video card.
  4487.  
  4488. Diamond Stealth
  4489.     GDS automatically detects the Stealth and tries to work around most
  4490.     of the problems with the Stealth.  There are known problems with the
  4491.     1280x960x16 and 1280x1024x16 modes.  They almost work, but not all of
  4492.     the graphics data is displayed in these modes.  Unfortunately, there
  4493.     is nothing GDS can do about the BIOS bugs with these two modes.
  4494.  
  4495.     Make sure you have run STLMODE before running GDS, or VESA will not
  4496.     work and may crash your machine.  We recommend adding the following
  4497.     line to your AUTOEXEC.BAT file:
  4498. 
  4499.         STLMODE VESA
  4500.  
  4501. Diamond Stealth Pro
  4502.     GDS automatically detects the Stealth and tries to work around most
  4503.     of the problems with the Stealth Pro.
  4504.  
  4505.     Make sure you have run STLMODE before running GDS, or VESA will not
  4506.     work and may crash your machine.  We recommend adding the following
  4507.     line to your AUTOEXEC.BAT file:
  4508. 
  4509.         STLMODE VESA
  4510.  
  4511. Diamond Stealth 64
  4512.     GDS automatically detects the Stealth 64 and tries to work around
  4513.     most of the problems with the Stealth 64.
  4514.  
  4515.     Make sure you have run S64MODE before running GDS.  Refer to the
  4516.     documentation that came with the card.  If you have trouble, contact
  4517.     Diamond Computers.
  4518.  
  4519. Diamond Viper VLB/PCI
  4520.     Make sure you have run VPRMODE before running GDS, or VESA will not
  4521.     work and may crash your machine.  We recommend adding the following
  4522.     line to your AUTOEXEC.BAT file:
  4523. 
  4524.         VPRMODE VESA
  4525.  
  4526. :::hlConfBadMode
  4527. Bad Looking Modes
  4528.  
  4529. Sometimes, GDS will try to display a test screen and give the beep because it
  4530. wants to know what you think of the current mode.  The only problem is that
  4531. the mode doesn't work right.
  4532.  
  4533. There are several reasons why modes don't work ok.  Some are correctable and
  4534. some are not.  Use the following list to determine what to do after you hear
  4535. the beep, but are not satisfied with the test pattern:
  4536. 
  4537.   If you've heard a beep, but see one of the following:
  4538. 
  4539.     Nothing:    The mode is dead, type [N] to kill the mode and
  4540.             continue.
  4541.  
  4542.     Moving Junk:    The monitor can't sync to the mode.  Type [N] quickly
  4543.             to kill the mode and continue.
  4544.  
  4545.     Solid Junk:    If the screen is not jumping or moving around, the
  4546.             mode may be correctable.  Try to use the left and
  4547.             right arrow keys to adjust the skew (number of
  4548.             logical bytes per line).  If this works, the video
  4549.             card's BIOS may have bugs in the VESA support.
  4550.  
  4551.     Squished Left:    If the screen looks scrunched a bit to the left and
  4552.             has color artifacts, but is generally greenish or
  4553.             gray, the mode may be an improperly reported 32bpp
  4554.             24 bit color mode.  Try typing '3' to try 32 bit
  4555.             mode, or '2' for 24 bit mode.
  4556.  
  4557.  
  4558. :::hlConfRept
  4559. Repeated Configurations
  4560.  
  4561. If GDS keeps putting you through the configuration every time you run GDS,
  4562. then remove the semicolon (';') before the following line in hlConfFileGDSUSER.CFG:
  4563. 
  4564.   auto,/ok    ;assume CONFIG file is ok
  4565. 
  4566. GDS checks the very beginning of the video BIOS to determine if the video
  4567. hardware has changed, and automatically reconfigures video modes when it has.
  4568. Some very recent video cards change the contents of the video BIOS, which
  4569. tricks GDS into thinking they are a new video card.  The "/OK" switch
  4570. prevents GDS from automatically reconfiguring the video modes because of a
  4571. video BIOS change.
  4572.  
  4573. If a BIOS change does occur, GDS prompts to allow you to reconfigure or not.
  4574.  
  4575. :::hlConfCrash
  4576. Crashing Modes
  4577.  
  4578. If GDS crashes immediately after starting the configuration process, try using
  4579. the hl/LAPTOP/LAPTOP command line parameter when running GDS.  If this does
  4580. not solve the problem, call hlPhotodexPhotodex for help.
  4581.  
  4582. IF YOU FIND A CRASHING MODE, call us and tell us.  If we know about it, we may
  4583. be able to fix the problem, or at least force GDS to not try that particular
  4584. mode with the particular card you have.
  4585.  
  4586. Sometimes video cards have such severe bugs that they can crash the entire
  4587. machine.  If the machine hangs for more than about 15-20 seconds with no
  4588. noticeable screen change, then the video BIOS has probably crashed the system.
  4589.  
  4590. The usual case is where the first few modes work ok, and then GDS attempts to
  4591. support an SVGA mode via the BIOS, which locks the machine.  You need to
  4592. identify the mode BEFORE the offending mode and delete it manually.
  4593.  
  4594. Follow these steps carefully to avoid a crashing mode:
  4595. 
  4596. 1) Start GDS again, and remember the resolution and number of bits displayed
  4597.    at the upper left of each screen as you type [Y] to accept it (or [N] to
  4598.    reject it.)  This should be a number like 640x480x256, or 1024x768x65536.
  4599.    When the machine locks up again, you will now know the mode just before
  4600.    the mode to be omitted.
  4601.  
  4602. 2) Reboot your machine.
  4603.  
  4604. 3) Start GDS again, and go through the modes until the test screen appears
  4605.    for the mode you've remembered from step 1.  Press [Enter] to force GDS
  4606.    into text mode.  This prevents GDS from trying to set any graphics modes.
  4607.  
  4608. *NOTE:    This text display shows the resolutions in the text window, but never
  4609.     attempts to actually set the mode.  Because of this, you are "blind"
  4610.     as to whether or not the mode actually works, but this allows you to
  4611.     skip over modes which do not work at all.
  4612.  
  4613. 4) Approve (or disapprove) the mode mentioned in step 1 by pressing [Y] to
  4614.    accept the mode (or [N] to reject it).
  4615.  
  4616. 5) The mode which has a problem will now appear displayed in the text window.
  4617.    Press [N] to omit the mode from the mode list.
  4618.  
  4619. 6) Now you should be looking at a new resolution that you haven't seen before,
  4620.    which is the mode AFTER the one which was causing the problem.  If you
  4621.    press [Enter], GDS will go into the graphics configuration mode again, and
  4622.    attempt to show you a test screen for the mode.
  4623.  
  4624. *NOTE:    BEWARE that video cards with bad modes may have more than one bad
  4625.     mode, and they could appear one after another.  If the machine locks
  4626.     up again, then you need to skip the modes as described above without
  4627.     going into graphics mode again.  Using steps 1-6, you can pop in and
  4628.     out of text and graphics (test screen) mode as much as you like.
  4629.  
  4630. :::hlConfPU
  4631. Power User's Configuration Quick-Start
  4632.  
  4633. The following points will save you as much time as possible, and assume that
  4634. you know basically what you're doing.  DO NOT take anything for granted or
  4635. assume that GDS is screwed up.  If you have a strange problem, try
  4636. hlPhotodexcalling before giving up.  We'd like to get your feedback.
  4637.  
  4638. 1) DO NOT hit [Esc] to exit the configuration because you're impatient.  A
  4639.    successful configuration usually takes 30-60 seconds to complete.
  4640.  
  4641. 2) When GDS beeps during configuration, it's waiting for a keystroke after
  4642.    displaying a screen.  Don't assume the machine has crashed until 15 seconds
  4643.    happens before a noticeable change is seen or beep is heard.  Some video
  4644.    cards take a long time to set some video modes.
  4645.  
  4646. 3) When GDS beeps, it means that the software believes that the current mode
  4647.    works, and GDS has drawn a valid test pattern.  If you see:
  4648.  
  4649.     Nothing:    The mode is dead, type [N] to kill the mode and
  4650.             continue.
  4651.  
  4652.     Moving Junk:    The monitor can't sync to the mode.  Type [N] quickly
  4653.             to kill the mode and continue.
  4654.  
  4655.     Solid Junk:    If the screen is not jumping around, the mode may
  4656.             be good.  Try to use the left and right arrow keys to
  4657.             adjust the skew (number of logical bytes per line).
  4658.             If this works, the VESA BIOS may have bugs.
  4659.  
  4660.     Almost Ok:    If the screen looks scrunched a bit to the left and
  4661.             has color artifacts but is generally greenish or gray,
  4662.             the mode may be an improperly reported 32bpp 24 bit
  4663.             color mode.  Try typing '3' to try 32 bit mode, or
  4664.             '2' for 24 bit mode.
  4665.  
  4666. 4) If a mode crashes the machine, refer to hlConfCrashCrashing Modes.
  4667.  
  4668. 5) Watch to see that 15, 16 and 24 bit modes have RED and BLUE correct in the
  4669.    upper left area of the screen.  Type [S] to swap RED and BLUE.
  4670.  
  4671. QUICK NOTE:  If you have a VESA compatible SVGA and GDS doesn't recognize all
  4672. of the modes the card is supposed to support, delete the file called "CONFIG"
  4673. and run GDS again by specifying hlCmdVH/VESA on the command line
  4674. (Type: GDS hlCmdVH/VESA).
  4675.  
  4676. Related Topics
  4677.     hlCmdVHVideo Hardware Parameters
  4678.     hlRevRevision History
  4679.  
  4680.  
  4681. :::hlHelp
  4682. Help With Help
  4683.  
  4684. You are using GDS's built-in hypertext help system.  Help is divided into
  4685. messages, which may contain text buttons which link to other help messages.
  4686. This help system is similar to the Windows help system.
  4687.  
  4688. To scroll the screen up and down, you can use the page and arrow keys, or move
  4689. the mouse to the top and bottom of the screen.
  4690.  
  4691. Text buttons are displayed in bright white, and can be selected by clicking on
  4692. them, or by using the [Tab] and [Enter] keys to switch buttons and finally
  4693. select one.
  4694.  
  4695. To exit a GDS help message, press the [Esc] key or click the mouse at the top
  4696. of the help screen.  Note that you can be into help several levels deep, so
  4697. exiting multiple help messages may be necessary to get all the way out of
  4698. help.
  4699.  
  4700.  
  4701.      [Up]    [PgUp]
  4702.             Scroll the screen (mouse works also)
  4703.     [Down]    [PgDn]
  4704. :::GDS.CFG
  4705. ;VIDEO CONFIGURATION FILE FORMAT:
  4706. ;
  4707. ;  This file was created to support GDS.  It is also a great reference
  4708. ;  of most video modes supported on a lot of cards, but in no way is a
  4709. ;  "complete" or fully tested list.  Use this list at your own risk.
  4710. ;  If you use this list in software, please give Paul Schmidt credit
  4711. ;  for the effort of creating this list.  It's a lot of work.  The
  4712. ;  author assumes no responsibility for the accuracy of this list.
  4713. ;
  4714. ;  If you discover errors, ommissions, or have suggestions, please
  4715. ;  contact Photodex and specifically reference the GDS.CFG file.
  4716. ;
  4717.  
  4718. ;NOTE:  Any ';' will cause GDS to ignore to the end of the line.
  4719. ;       If a video mode is giving you problems, you can disable it
  4720. ;       by inserting a ';' in front of the line which describes it.
  4721.  
  4722. ;Argument Definitions
  4723. ;<name> is the name of the video display (7 characters MAXIMUM)
  4724. ;<hRes> and <vRes> are the screen resolution
  4725. ;<bpix> is the number of bits per pixel
  4726. ;<ax>, <bx>, <cx>, and <dx> are the processor registers on a call to
  4727. ;           "int 010h" unless <directFlag> is non-zero
  4728. ;<dirct> indicates the base address for text modes, and tells if
  4729. ;           the graphics mode should be initialized by directly
  4730. ;           accessing the VGA registers. (0, 1, or text base address)
  4731. ;           
  4732. ;<format> dictates the screen format (0 is normal, 1 is chunky 4-bit)
  4733. ;
  4734. ;<name>    <hRes>    <vRes>    <bpix>    <ax>    <bx>    <cx>    <dx>    <dirct>    <dotMode>
  4735.  
  4736. ;dot modes:
  4737. ;    0 = standard planar 16 or bytewide 256 color mapping
  4738. ;    1 = 4 bit chunky
  4739. ;    2 = planar 256 color (tweeked VGA modes)
  4740. ;    3 = TIGA modes (automatically detected)
  4741. ;    5 = Sierra Hi-Color DAC (32,768 colors)
  4742. ;        NOTE: Sierra DAC Hi-Color modes are automatically queried for
  4743. ;        BIOS support if the <ax> value is set to 0x10f0.  If you know
  4744. ;        the mode number of a Hi-Color mode for your card, you may set
  4745. ;        the values of the <ax> and <bx> registers to something
  4746. ;        other than 0x10f0, and GDS will assume the mode is supported.
  4747. ;    6 = RESERVED (DO NOT USE THIS)
  4748. ;    7 = Hercules monochrome
  4749. ;    8 = CGA monochrome
  4750. ;    9 = 4 bit chunky reverse order (BARF)
  4751. ;    10 = 24 bit DAC (16M colors) Standard order: RGB
  4752. ;        NOTE: Some 24 bit DAC modes are automatically queried for
  4753. ;        BIOS support if the <ax> value is set to 0x10e0.  If you know
  4754. ;        the mode number of a 24 bit mode for your card, you may set
  4755. ;        the values of the <ax> and <bx> registers to something
  4756. ;        other than 0x10e0, and GDS will assume the mode is supported.
  4757. ;    11 = 24 bit DAC (16M colors) Reverse order: BGR
  4758. ;    12 = 24 bit DAC (16M colors) Standard order: RGBX
  4759. ;        NOTE: Some 24 bit DAC modes are automatically queried for
  4760. ;        BIOS support if the <ax> value is set to 0x10e0.  If you know
  4761. ;        the mode number of a 24 bit mode for your card, you may set
  4762. ;        the values of the <ax> and <bx> registers to something
  4763. ;        other than 0x10e0, and GDS will assume the mode is supported.
  4764. ;    13 = 24 bit DAC (16M colors) Reverse order: BGRX
  4765.  
  4766. ;HERCULES
  4767. HERC,    720,    348,    1,    0,    0,    0,    0,    1,    7    ;hercules
  4768.  
  4769. ;STANDARD CGA
  4770. CGA,    640,    200,    1,    0x6,    0,    0,    0,    0,    8    ;CGA monochrome
  4771. CGA,    320,    200,    2,    0x4,    0,    0,    0,    0,    0
  4772.  
  4773. ;STANDARD EGA
  4774. EGA,    80,    25,    0,    0x3,    0,    0,    0,    0xb800,    0    ;default text mode
  4775. EGA,    320,    200,    4,    0xd,    0,    0,    0,    0,    0
  4776. EGA,    640,    200,    4,    0xe,    0,    0,    0,    0,    0
  4777. EGA,    640,    350,    4,    0x10,    0,    0,    0,    0,    0
  4778.  
  4779. ;STANDARD VGA
  4780. VGA,    640,    480,    1,    0x11,    0,    0,    0,    0,    0
  4781. VGA,    640,    480,    4,    0x12,   0,    0,    0,    0,    0
  4782. VGA,    320,    200,    8,    0x13,    0,    0,    0,    0,    0
  4783.  
  4784. ;NON-STANDARD VGA (FOR REGISTER COMPATIBLE VGA CARDS ONLY!!!)
  4785. VGA,    320,    240,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
  4786. VGA,    320,    400,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
  4787. VGA,    360,    480,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
  4788. ;VGA,    704,    528,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4789. ;VGA,    720,    540,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4790. ;VGA,    736,    552,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4791. ;VGA,    752,    564,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4792. ;VGA,    768,    576,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4793. ;VGA,    784,    588,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4794. ;VGA,    800,    600,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4795. ;VGA,    640,    400,    8,    0,    0,    0,    0,    1,    0    ;works with some register compatible VGAs!
  4796. ;   NOTE: If you'd like to use these modes (and you have a registered
  4797. ;    version), we strongly recommended that you move these definitions
  4798. ;    into GDSUSER.CFG and remove the semicolons (';').  This will prevent
  4799. ;    new versions from overwriting your preferences.  Unregistered
  4800. ;    versions of GDS do not read GDSUSER.CFG.
  4801.  
  4802. ;AHEAD SYSTEMS
  4803. AHEAD,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  4804. AHEAD,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
  4805. AHEAD,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  4806. AHEAD,    160,    50,    0,    0x2f,    0,    0,    0,    0xb800,    0
  4807. AHEAD,    80,    66,    0,    0x34,    0,    0,    0,    0xb800,    0
  4808. AHEAD,    1024,    768,    2,    0x75,    0,    0,    0,    0,    0
  4809. AHEAD,    640,    400,    8,    0x60,    0,    0,    0,    0,    0
  4810. AHEAD,    640,    480,    8,    0x61,    0,    0,    0,    0,    0
  4811. AHEAD,    800,    600,    8,    0x62,    0,    0,    0,    0,    0
  4812.  
  4813. ;AHEAD SYSTEMS
  4814. AHEADB,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  4815. ;AHEADB, 132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0    ;not on all cards
  4816. AHEADB,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  4817. ;AHEADB, 160,    50,    0,    0x2f,    0,    0,    0,    0xb800,    0    ;not on all cards
  4818. ;AHEADB, 80,    66,    0,    0x34,    0,    0,    0,    0xb800,    0    ;not on all cards
  4819. AHEADB,    1024,    768,    2,    0x75,    0,    0,    0,    0,    0
  4820. AHEADB,    800,    600,    4,    0x6a,    0,    0,    0,    0,    0
  4821. AHEADB,    1024,    768,    4,    0x74,    0,    0,    0,    0,    0
  4822. AHEADB,    640,    400,    8,    0x60,    0,    0,    0,    0,    0
  4823. AHEADB,    640,    480,    8,    0x61,    0,    0,    0,    0,    0
  4824. AHEADB,    800,    600,    8,    0x62,    0,    0,    0,    0,    0
  4825. AHEADB,    1024,    768,    8,    0x63,    0,    0,    0,    0,    0
  4826.  
  4827. ;ATI Wonder
  4828. ATI,    80,    30,    0,    0x5b,    0,    0,    0,    0xb800,    0
  4829. ATI,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  4830. ATI,    132,    44,    0,    0x33,    0,    0,    0,    0xb800,    0
  4831. ATI,    1024,    768,    2,    0x67,   0,    0,    0,    0,    1
  4832. ATI,    800,    600,    4,    0x54,   0,    0,    0,    0,    0
  4833. ;ATI,    1024,    768,    4,    0x55,   0,    0,    0,    0,    0    ;bank selection for video reads
  4834.                                         ;doesn't seem to work properly in
  4835. ;ATI,    1024,    768,    4,    0x65,   0,    0,    0,    0,    1
  4836. ATI,    640,    400,    8,    0x61,    0,    0,    0,    0,    0
  4837. ATI,    640,    480,    8,    0x62,    0,    0,    0,    0,    0
  4838. ATI,    800,    600,    8,    0x63,    0,    0,    0,    0,    0
  4839. ATI,    1024,    768,    8,    0x64,   0,    0,    0,    0,    0
  4840. ATI,    640,    480,    15,    0x72,    0,    0,    0,    0,    5
  4841.  
  4842. ;CHIPS & TECHNOLOGIES
  4843. CHIPS,    132,    25,    0,    0x60,    0,    0,    0,    0xb800,    0
  4844. CHIPS,    132,    50,    0,    0x61,    0,    0,    0,    0xb800,    0
  4845. CHIPS,    800,    600,    4,    0x70,    0,    0,    0,    0,    0
  4846. CHIPS,    1024,    768,    4,    0x72,    0,    0,    0,    0,    0
  4847. CHIPS,    640,    400,    8,    0x78,    0,    0,    0,    0,    0
  4848. CHIPS,    640,    480,    8,    0x79,    0,    0,    0,    0,    0
  4849. CHIPS,    768,    576,    8,    0x7a,    0,    0,    0,    0,    0
  4850. CHIPS,    800,    600,    8,    0x7b,    0,    0,    0,    0,    0
  4851.  
  4852. ;CIRRUS 510,520 - MaxLogic MaxVGA
  4853. CIRRUS,    132,    25,    0,    0x1f,    0,    0,    0,    0xb800,    0
  4854. CIRRUS,    132,    30,    0,    0x22,    0,    0,    0,    0xb800,    0
  4855. CIRRUS,    132,    44,    0,    0x20,    0,    0,    0,    0xb800,    0
  4856. CIRRUS,    720,    540,    4,    0x40,    0,    0,    0,    0,    0
  4857. CIRRUS,    800,    600,    4,    0x6a,    0,    0,    0,    0,    0
  4858. CIRRUS,    640,    400,    8,    0x50,    0,    0,    0,    0,    2
  4859. ;CIRRUS, 512,    480,    8,    0x51,    0,    0,    0,    0,    0    ;NOTE: use only with the TSR BIOS extension!
  4860.  
  4861. ;CL54 54xx - Cirrus Logic SVGA Chips
  4862. CL54,    132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  4863. CL54,    132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
  4864. CL54,    132,    60,    0,    0x53,    0,    0,    0,    0xb800,    0    ;if you're brave
  4865. CL54,    800,    600,    4,    0x58,    0,    0,    0,    0,    0
  4866. CL54,    1024,    768,    4,    0x5d,    0,    0,    0,    0,    0
  4867. CL54,    1280,    1024,    4,    0x6c,    0,    0,    0,    0,    0
  4868. CL54,    640,    480,    8,    0x5f,    0,    0,    0,    0,    0
  4869. CL54,    800,    600,    8,    0x5c,    0,    0,    0,    0,    0
  4870. CL54,    1024,    768,    8,    0x60,    0,    0,    0,    0,    0
  4871. CL54,    1280,    1024,    8,    0x6d,    0,    0,    0,    0,    0
  4872. CL54,    640,    480,    15,    0x66,    0,    0,    0,    0,    5
  4873. CL54,    800,    600,    15,    0x67,    0,    0,    0,    0,    5
  4874. CL54,    640,    480,    16,    0x64,    0,    0,    0,    0,    0
  4875. CL54,    800,    600,    16,    0x65,    0,    0,    0,    0,    0
  4876. CL54,    1024,    768,    16,    0x74,    0,    0,    2048,    0,    0
  4877. CL54,    320,    200,    24,    0x70,    0,    0,    2048,    0,    11
  4878. CL54,    640,    480,    24,    0x71,    0,    0,    2048,    0,    11
  4879.  
  4880. ;EVEREX
  4881. EVEREX,    800,    600,    4,    0x70,    0x02,    0,    0,    0,    0
  4882. EVEREX,    640,    350,    8,    0x70,    0x13,    0,    0,    0,    0
  4883. EVEREX,    640,    400,    8,    0x70,    0x14,    0,    0,    0,    0
  4884. EVEREX,    512,    480,    8,    0x70,    0x15,    0,    0,    0,    0
  4885. EVEREX,    640,    480,    8,    0x70,    0x30,    0,    0,    0,    0
  4886. EVEREX,    800,    600,    8,    0x70,    0x31,    0,    0,    0,    0
  4887.  
  4888. ;EV634 - EVEREX Viewpoint Premium VGA (EV-634)
  4889. EV634,    80,    30,    0,    0x70,    0x16,    0,    0,    0xb800,    0
  4890. EV634,    80,    34,    0,    0x70,    0x03,    0,    0,    0xb800,    0
  4891. EV634,    80,    60,    0,    0x70,    0x04,    0,    0,    0xb800,    0
  4892. EV634,    100,    37,    0,    0x70,    0x18,    0,    0,    0xb800,    0
  4893. EV634,    100,    43,    0,    0x70,    0x07,    0,    0,    0xb800,    0
  4894. EV634,    100,    75,    0,    0x70,    0x08,    0,    0,    0xb800,    0
  4895. EV634,    132,    25,    0,    0x70,    0x0a,    0,    0,    0xb800,    0
  4896. EV634,    132,    30,    0,    0x70,    0x40,    0,    0,    0xb800,    0
  4897. EV634,    132,    44,    0,    0x70,    0x0b,    0,    0,    0xb800,    0
  4898. EV634,    1024,    768,    2,    0x70,    0x60,    0,    0,    0,    0    ;this mode seems to exist only in the documentation...
  4899. EV634,    800,    600,    4,    0x70,    0x02,    0,    0,    0,    0
  4900. EV634,    1024,    768,    4,    0x70,    0x20,    0,    0,    0,    0
  4901. EV634,    1280,    1024,    4,    0x70,    0x21,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  4902. EV634,    1664,    1200,    4,    0x70,    0x23,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  4903. EV634,    640,    400,    8,    0x70,    0x14,    0,    0,    0,    0
  4904. EV634,    512,    480,    8,    0x70,    0x15,    0,    0,    0,    0
  4905. EV634,    640,    480,    8,    0x70,    0x30,    0,    0,    0,    0
  4906. EV634,    800,    600,    8,    0x70,    0x31,    0,    0,    0,    0
  4907. EV634,    1024,    768,    8,    0x70,    0x32,    0,    0,    0,    0
  4908. EV634,    320,    200,    15,    0x70,    0x62,    0,    0,    0,    5
  4909. EV634,    512,    480,    15,    0x70,    0x70,    0,    0,    0,    5
  4910. EV634,    640,    480,    15,    0x70,    0x71,    0,    0,    0,    5
  4911. EV634,    800,    600,    15,    0x70,    0x63,    0,    0,    0,    5
  4912.  
  4913. ;ORCHID Farenheit 1280 (S3)
  4914. F1280,    132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  4915. F1280,    132,    44,    0,    0x54,    0,    0,    0,    0xb800,    0
  4916. F1280,    800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  4917. F1280,    1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  4918. F1280,    1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
  4919. F1280,    1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    1    ;NOTE: Way cool monitors only!
  4920. F1280,    640,    480,    8,    0x4f02,    0x201,    0,    1024,    0,    0
  4921. F1280,    800,    600,    8,    0x4f02,    0x203,    0,    1024,    0,    0
  4922. F1280,    1024,    768,    8,    0x4f02,    0x205,    0,    0,    0,    0
  4923. F1280,    640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
  4924.  
  4925. ;GENOA 6000 series (6100, 6200, 6300, 6400, 6600)
  4926. ;      THANX: Herman, Steve, and Decker w/Genoa customer support
  4927. GENOA,    80,    32,    0,    0x58,    0,    0,    0,    0xb800,    0
  4928. GENOA,    80,    60,    0,    0x72,    0,    0,    0,    0xb800,    0
  4929. GENOA,    80,    66,    0,    0x74,    0,    0,    0,    0xb800,    0
  4930. GENOA,    100,    37,    0,    0x78,    0,    0,    0,    0xb800,    0
  4931. GENOA,    132,    25,    0,    0x60,    0,    0,    0,    0xb800,    0
  4932. GENOA,    132,    29,    0,    0x61,    0,    0,    0,    0xb800,    0
  4933. GENOA,    132,    32,    0,    0x62,    0,    0,    0,    0xb800,    0
  4934. GENOA,    132,    44,    0,    0x63,    0,    0,    0,    0xb800,    0
  4935. GENOA,    132,    60,    0,    0x64,    0,    0,    0,    0xb800,    0
  4936. GENOA,    1024,    768,    2,    0x7f,    0,    0,    0,    0,    0
  4937. GENOA,    800,    600,    4,    0x79,    0,    0,    0,    0,    0
  4938. GENOA,    1024,    768,    4,    0x5f,    0,    0,    0,    0,    0
  4939. GENOA,    640,    400,    8,    0x7e,    0,    0,    0,    0,    0
  4940. GENOA,    640,    480,    8,    0x5c,    0,    0,    0,    0,    0
  4941. GENOA,    800,    600,    8,    0x5e,    0,    0,    0,    0,    0
  4942. ;GENOA,    100,    75,    0,    0x79,    0,    0,    0,    0xb800,    0    ;I think these are dead modes from a
  4943. ;GENOA,    512,    512,    4,    0x7c,    0,    0,    0,    0,    0    ;   beta version of Genoa's BIOS
  4944. ;GENOA,    720,    512,    4,    0x59,    0,    0,    0,    0,    0
  4945. ;GENOA,    512,    512,    8,    0x7d,    0,    0,    0,    0,    0
  4946. ;GENOA,    640,    350,    8,    0x5b,    0,    0,    0,    0,    0
  4947. ;GENOA,    720,    512,    8,    0x5d,    0,    0,    0,    0,    0
  4948.  
  4949. ;OAKTECH
  4950. OAK,    132,    25,    0,    0x50,    0,    0,    0,    0xb800,    0
  4951. OAK,    132,    43,    0,    0x51,    0,    0,    0,    0xb800,    0
  4952. OAK,    132,    60,    0,    0x4f,    0,    0,    0,    0xb800,    0
  4953. OAK,    800,    600,    4,    0x52,    0,    0,    0,    0,    0
  4954. OAK,    1024,    768,    4,    0x56,    0,    0,    0,    0,    0
  4955. OAK,    640,    480,    8,    0x53,    0,    0,    0,    0,    0
  4956. OAK,    800,    600,    8,    0x54,    0,    0,    0,    0,    0
  4957.  
  4958. ;PARADISE (Paradise VGA 1024)
  4959. ;PARA,   800,    600,    8,      0x59,   0,      0,      0,      0,      0 ;Genoa 8500
  4960. ;PARA,  1024,    768,    8,      0x5a,   0,      0,      0,      0,      0 ;Genoa 8500
  4961. PARA,   132,    25,     0,      0x55,   0,      0,      0,      0,      0
  4962. PARA,   132,    43,     0,      0x54,   0,      0,      0,      0,      0
  4963. PARA,    800,    600,    1,    0x59,    0,    0,    0,    0,    0
  4964. PARA,    1024,    768,    1,    0x5a,    0,    0,    0,    0,    0    ;is SMT-1024 mode 0x5c for this?
  4965. PARA,    1024,    768,    2,    0x5b,    0,    0,    0,    0,    0    ;is SMT-1024 mode 0x5c for this?
  4966. PARA,   800,    600,    4,      0x58,   0,      0,      0,      0,      0
  4967. PARA,   1024,   768,    4,      0x5d,   0,      0,      0,      0,      0 ;is SMT-1024 mode 0x5c for this?
  4968. PARA,  1280,    960,    4,      0x6C,   0,      0,      0,      0,      0
  4969. PARA,  1280,   1024,    4,      0x64,   0,      0,      0,      0,      0
  4970. PARA,   640,    400,    8,      0x5e,   0,      0,      0,      0,      0
  4971. PARA,   640,    480,    8,      0x5f,   0,      0,      0,      0,      0
  4972. PARA,   800,    600,    8,      0x5c,   0,      0,      0,      0,      0
  4973. PARA,  1024,    768,    8,      0x60,   0,      0,      0,      0,      0
  4974. PARA,   640,    480,   15,      0x62,   0,      0,      0,      0,      5
  4975. PARA,   800,    600,   15,      0x63,   0,      0,      0,      0,      5
  4976. PARA,   640,    480,   24,      0x72,   0,      0,      0,      0,     10
  4977.  
  4978. ;Diamond Computer Speedstar 24X (*NOT* Speedstar 24)
  4979. SS24X,    80,    34,    0,    0x41,    0,    0,    0,    0,    0
  4980. SS24X,    80,    43,    0,    0x67,    0,    0,    0,    0,    0
  4981. SS24X,    80,    50,    0,    0x66,    0,    0,    0,    0,    0
  4982. SS24X,    132,    25,    0,    0x55,    0,    0,    0,    0,    0
  4983. SS24X,    132,    28,    0,    0x47,    0,    0,    0,    0,    0
  4984. SS24X,    132,    43,    0,    0x54,    0,    0,    0,    0,    0
  4985. SS24X,    132,    44,    0,    0x21,    0,    0,    0,    0,    0
  4986. SS24X,    132,    50,    0,    0x69,    0,    0,    0,    0,    0
  4987. SS24X,    800,    600,    4,    0x58,    0,    0,    0,    0,    0
  4988. SS24X,    1024,    768,    4,    0x5d,    0,    0,    0,    0,    0
  4989. SS24X,    1280,    960,    4,    0x6c,    0,    0,    0,    0,    0
  4990. SS24X,    1280,    1024,    4,    0x64,    0,    0,    0,    0,    0
  4991. SS24X,    640,    400,    8,    0x5e,    0,    0,    0,    0,    0
  4992. SS24X,    640,    480,    8,    0x5f,    0,    0,    0,    0,    0
  4993. SS24X,    800,    600,    8,    0x5c,    0,    0,    0,    0,    0
  4994. SS24X,    1024,    768,    8,    0x60,    0,    0,    0,    0,    0
  4995. SS24X,    640,    480,    15,    0x62,    0,    0,    0,    0,    5
  4996. SS24X,    800,    600,    15,    0x63,    0,    0,    0,    0,    5
  4997. SS24X,    640,    480,    24,    0x72,    0,    0,    0,    0,    10
  4998.  
  4999. ;Diamond Computer Stealth 64 (S3)
  5000. ST64,    640,    480,    24,    0x4f02,    0x112,    0,    4096,    0,    13
  5001. ST64,    800,    600,    24,    0x4f02,    0x115,    0,    4096,    0,    13
  5002. ST64,    1024,    768,    24,    0x4f02,    0x118,    0,    4096,    0,    13
  5003. ST64,    1152,    864,    24,    0x4f02,    0x20b,    0,    4608,    0,    13
  5004.                                      
  5005. ;Diamond Computer Stealth VRAM (S3)
  5006. STEALTH,132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  5007. STEALTH,132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
  5008. STEALTH,800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  5009. STEALTH,1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  5010. STEALTH,1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
  5011. STEALTH,1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    9
  5012. STEALTH,640,    480,    8,    0x4f02,    0x101,    0,    640,    0,    0
  5013. STEALTH,800,    600,    8,    0x4f02,    0x103,    0,    1024,    0,    0
  5014. STEALTH,1024,    768,    8,    0x4f02,    0x105,    0,    0,    0,    0
  5015. STEALTH,640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
  5016.  
  5017. ;Diamond Computer Stealth PRO (S3)
  5018. STPRO,132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  5019. STPRO,132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
  5020. STPRO,800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  5021. STPRO,1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  5022. STPRO,1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
  5023. STPRO,1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    9
  5024. STPRO,640,    480,    8,    0x4f02,    0x201,    0,    1024,    0,    0
  5025. STPRO,800,    600,    8,    0x4f02,    0x203,    0,    1024,    0,    0
  5026. STPRO,1024,    768,    8,    0x4f02,    0x205,    0,    0,    0,    0
  5027. STPRO,1280,    1024,    8,    0x4f02,    0x107,    0,    0,    0,    0
  5028. STPRO,640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
  5029. STPRO,640,    480,    16,    0x4f02,    0x211,    0,    2048,    0,    5
  5030. STPRO,800,    600,    16,    0x4f02,    0x114,    0,    0,    0,    5
  5031. STPRO,640,    480,    24,    0x4f02,    0x212,    0,    2048,    0,    10
  5032. STPRO,800,    600,    24,    0x4f02,    0x221,    0,    0,    0,    10
  5033.  
  5034. ;TRIDENT (Trident TVGA / ATI Prism Elite / Everex Viewpoint VGA)
  5035. TRIDNT,    80,    30,    0,    0x50,    0,    0,    0,    0xb800,    0
  5036. TRIDNT,    80,    43,    0,    0x51,    0,    0,    0,    0xb800,    0
  5037. TRIDNT,    80,    60,    0,    0x52,    0,    0,    0,    0xb800,    0
  5038. TRIDNT,    132,    25,    0,    0x53,    0,    0,    0,    0xb800,    0
  5039. TRIDNT,    132,    30,    0,    0x54,    0,    0,    0,    0xb800,    0
  5040. TRIDNT,    132,    43,    0,    0x55,    0,    0,    0,    0xb800,    0
  5041. TRIDNT,    132,    60,    0,    0x56,    0,    0,    0,    0xb800,    0
  5042. ;TRIDNT,132,    25,    0,    0x57,    0,    0,    0,    0xb800,    0    ;these four modes work, but
  5043. ;TRIDNT,132,    30,    0,    0x58,    0,    0,    0,    0xb800,    0    ;don't seem to be necessary.
  5044. ;TRIDNT,132,    43,    0,    0x59,    0,    0,    0,    0xb800,    0
  5045. ;TRIDNT,132,    60,    0,    0x5a,    0,    0,    0,    0xb800,    0
  5046. TRIDNT,    1024,    768,    2,    0x60,    0,    0,    0,    0,    0
  5047. ;TRIDNT, 768,    1024,    4,    0x61,    0,    0,    0,    0,    0    ;use portrait CRT ONLY!!! (Magics 15FP)
  5048. TRIDNT,    800,    600,    4,    0x5b,    0,    0,    0,    0,    0
  5049. TRIDNT,    1024,    768,    4,    0x5f,    0,    0,    0,    0,    0
  5050. TRIDNT,    640,    400,    8,    0x5c,    0,    0,    0,    0,    0
  5051. TRIDNT,    640,    480,    8,    0x5d,    0,    0,    0,    0,    0
  5052. TRIDNT,    800,    600,    8,    0x5e,    0,    0,    0,    0,    0
  5053. TRIDNT,    1024,    768,    8,    0x62,    0,    0,    0,    0,    0
  5054.  
  5055. ;TSENG LABS ET3000 (STB VGA EM-16)
  5056. TSENG,    80,    60,    0,    0x26,    0,    0,    0,    0xb800,    0
  5057. TSENG,    100,    40,    0,    0x2a,    0,    0,    0,    0xb800,    0
  5058. TSENG,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  5059. TSENG,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
  5060. TSENG,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  5061. TSENG,    800,    600,    4,    0x29,    0,    0,    0,    0,    0
  5062. TSENG,    1024,    768,    4,    0x37,    0,    0,    0,    0,    0
  5063. TSENG,    640,    350,    8,    0x2d,    0,    0,    0,    0,    0
  5064. TSENG,    640,    480,    8,    0x2e,    0,    0,    0,    0,    0
  5065. TSENG,    720,    512,    8,    0x2f,    0,    0,    0,    0,    0
  5066. TSENG,    800,    600,    8,    0x30,    0,    0,    0,    0,    0
  5067.  
  5068. ;TSENG LABS ET4000
  5069. TSENG4,    80,    60,    0,    0x26,    0,    0,    0,    0xb800,    0
  5070. TSENG4,    100,    40,    0,    0x2a,    0,    0,    0,    0xb800,    0
  5071. TSENG4,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  5072. TSENG4,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
  5073. TSENG4,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  5074. TSENG4,    800,    600,    4,    0x29,    0,    0,    0,    0,    0
  5075. TSENG4,    1024,    768,    4,    0x37,    0,    0,    0,    0,    0
  5076. TSENG4,    640,    350,    8,    0x2d,    0,    0,    0,    0,    0
  5077. TSENG4,    640,    400,    8,    0x2f,    0,    0,    0,    0,    0
  5078. TSENG4,    640,    480,    8,    0x2e,    0,    0,    0,    0,    0
  5079. TSENG4,    800,    600,    8,    0x30,    0,    0,    0,    0,    0
  5080. TSENG4,    1024,    768,    8,    0x38,    0,    0,    0,    0,    0
  5081. TSENG4,    320,    200,    15,    0x10f0,    0x13,    0,    0,    0,    5    ;queried Sierra Hi-Color modes
  5082. TSENG4,    640,    350,    15,    0x10f0,    0x2d,    0,    0,    0,    5
  5083. TSENG4,    640,    400,    15,    0x10f0,    0x2f,    0,    0,    0,    5
  5084. TSENG4,    640,    480,    15,    0x10f0,    0x2e,    0,    0,    0,    5
  5085. TSENG4,    800,    600,    15,    0x10f0,    0x30,    0,    0,    0,    5
  5086. TSENG4,    320,    200,    15,    0x10f0,    0x13,    0,    0,    0,    5    ;queried Sierra Hi-Color modes
  5087. TSENG4,    640,    350,    15,    0x10f0,    0x2d,    0,    0,    0,    5
  5088. TSENG4,    640,    480,    24,    0x10e0,    0x2e,    0,    2048,    0,    10    ;queried 24 bit modes
  5089.  
  5090. ;VESA (assumes all modes are present, comment out modes here which don't exist)
  5091. VESA,    800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  5092. VESA,    1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  5093. VESA,    1280,    1024,    4,    0x4f02,    0x106,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  5094. VESA,    640,    400,    8,    0x4f02,    0x100,    0,    0,    0,    0
  5095. VESA,    640,    480,    8,    0x4f02,    0x101,    0,    0,    0,    0
  5096. VESA,    800,    600,    8,    0x4f02,    0x103,    0,    0,    0,    0
  5097. VESA,    1024,    768,    8,    0x4f02,    0x105,    0,    0,    0,    0
  5098. VESA,    1280,    1024,    8,    0x4f02,    0x107,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  5099. VESA,    320,    200,    15,    0x4f02,    0x10d,    0,    0,    0,    5
  5100. VESA,    640,    480,    15,    0x4f02,    0x110,    0,    0,    0,    5
  5101. VESA,    800,    600,    15,    0x4f02,    0x113,    0,    0,    0,    5
  5102. VESA,    1024,    768,    15,    0x4f02,    0x116,    0,    0,    0,    5
  5103. VESA,    1280,    1024,    15,    0x4f02,    0x119,    0,    0,    0,    5    ;NOTE: Way cool monitors only!
  5104. VESA,    320,    200,    16,    0x4f02,    0x10e,    0,    0,    0,    0
  5105. VESA,    640,    480,    16,    0x4f02,    0x111,    0,    0,    0,    0
  5106. VESA,    800,    600,    16,    0x4f02,    0x114,    0,    0,    0,    0
  5107. VESA,    1024,    768,    16,    0x4f02,    0x117,    0,    0,    0,    0
  5108. VESA,    1280,    1024,    16,    0x4f02,    0x11a,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  5109. VESA,    320,    200,    24,    0x4f02,    0x10f,    0,    0,    0,    10
  5110. VESA,    640,    480,    24,    0x4f02,    0x112,    0,    0,    0,    10
  5111. VESA,    800,    600,    24,    0x4f02,    0x115,    0,    0,    0,    10
  5112. VESA,    1024,    768,    24,    0x4f02,    0x118,    0,    0,    0,    10
  5113. VESA,    1280,    1024,    24,    0x4f02,    0x11b,    0,    0,    0,    10    ;NOTE: Way cool monitors only!
  5114.  
  5115. ;VIDEO 7 (VEGA Deluxe, 1024i, VRAM VGA
  5116. VID7,    80,    43,    0,    0x6f05,    0x40,    0,    0,    0xb800,    0
  5117. VID7,    80,    60,    0,    0x6f05,    0x43,    0,    0,    0xb800,    0
  5118. VID7,    80,    67,    0,    0x6f05,    0x46,    0,    0,    0xb800,    0    ;may not be present (undocumented)
  5119. VID7,    100,    60,    0,    0x6f05,    0x44,    0,    0,    0xb800,    0
  5120. VID7,    132,    25,    0,    0x6f05,    0x41,    0,    0,    0xb800,    0
  5121. VID7,    132,    28,    0,    0x6f05,    0x45,    0,    0,    0xb800,    0
  5122. VID7,    132,    43,    0,    0x6f05,    0x42,    0,    0,    0xb800,    0
  5123. VID7,    1024,    768,    1,    0x6f05,    0x63,    0,    0,    0,    0
  5124. VID7,    1024,    768,    2,    0x6f05,    0x64,    0,    0,    0,    0
  5125. VID7,    720,    540,    4,    0x6f05,    0x61,    0,    0,    0,    0
  5126. VID7,    752,    410,    4,    0x6f05,    0x60,    0,    0,    0,    0
  5127. VID7,    800,    600,    4,    0x6f05,    0x62,    0,    0,    0,    0
  5128. VID7,    1024,    768,    4,    0x6f05,    0x65,    0,    0,    0,    0
  5129. VID7,    640,    400,    8,    0x6f05,    0x66,    0,    0,    0,    0
  5130. VID7,    640,    480,    8,    0x6f05,    0x67,    0,    0,    0,    0
  5131. VID7,    720,    540,    8,    0x6f05,    0x68,    0,    0,    0,    0    ;ONLY exists with V-RAM VGA
  5132. VID7,    800,    600,    8,    0x6f05,    0x69,    0,    0,    0,    0    ;ONLY exists with V-RAM VGA
  5133. VID7,    1024,    768,    8,    0x6f05,    0x6a,    0,    0,    0,    0    ;ONLY exists with V-RAM2 VGA
  5134. :::
  5135.